skynet debug_console控制台中debug指令使用

debug指令源码分析
debug指令使用方法
注意事项

debug指令源码分析

lua 复制代码

function COMMANDX.debug(cmd)
    local address = adjust_address(cmd[2])  -- 目标服务地址
    local agent = skynet.newservice "debug_agent"  -- 创建调试代理
    local stop
    local term_co = coroutine.running()
    
    -- 命令转发函数
    local function forward_cmd()
        repeat
            skynet.call(agent, "lua", "ping")  -- 检测代理是否存活
            local cmdline = socket.readline(cmd.fd, "\n")
            cmdline = cmdline and cmdline:gsub("(.*)\r$", "%1")
            if not cmdline then
                skynet.send(agent, "lua", "cmd", "cont")
                break
            end
            skynet.send(agent, "lua", "cmd", cmdline)  -- 转发命令到调试代理
        until stop or cmdline == "cont"
    end
    
    -- 启动命令转发协程
    skynet.fork(function()
        pcall(forward_cmd)
        if not stop then
            term_co = nil
        else
            skynet.wakeup(term_co)
        end
    end)
    
    -- 开始调试会话
    local ok, err = skynet.call(agent, "lua", "start", address, cmd.fd)
    stop = true
    if term_co then
        skynet.wait(term_co)  -- 等待转发协程退出
    end

    if not ok then
        error(err)
    end
end

debug指令使用方法

bash 复制代码

debug <服务地址>

获取服务地址

首先需要知道要调试的服务的地址：

bash 复制代码

# 连接到debug console
nc 127.0.0.1 8000

# 查看所有服务列表
list

具体使用示例

示例1：调试普通服务

bash 复制代码

# 连接到debug console
nc 127.0.0.1 8000

# 查看服务列表，找到目标服务地址
list
# 输出示例：
# :0100000b   snlua launcher
# :0100000c   snlua cmaster
# :0100000d   snlua cslave
# :0100000e   snlua datacenterd
# :0100000f   snlua service_mgr

# 调试datacenterd服务
debug :0100000e

示例2：使用服务名调试

bash 复制代码

# 如果服务有注册名字，可以使用名字
debug .launcher

控制流命令

bash 复制代码

// 跳出当前debug
cont

注意事项

安全警告

debug命令可以在目标服务中执行任意Lua代码
生产环境慎用，可能影响服务稳定性
调试会话会暂停服务的正常执行

使用限制

目标服务必须支持debug协议
某些服务可能有安全限制，拒绝调试
调试期间服务响应会变慢

在skynet的debug会话中，默认不支持多行输入。每次输入都是一行独立的Lua代码，不过可以使用分开写入多语句：

bash 复制代码

:0000005e>local faci = require "faci.module"; local module = faci.get_module("gm_mgr"); local dispatch = module.dispatch; return dispatch.shutdown_status()