socket.io服务端断点不生效，需attach到node.js进程而非express实例；断点应设在server.listen()或io.on('connection')等实际执行处，launch.json用attach模式配--inspect，并启用复合调试实现前后端断点联动。
Socket.io 服务端断点不生效？确认你 attach 的是 Node.js 进程，不是 Express app
VSCode 调试器无法在 io() 调用处打有效断点，根本原因是：你可能把断点设在了 new Server(app) 这类错误写法上——app 是 Express 实例，不是 HTTP server，socket.io 构造函数会直接抛出 Server requires a net.Server instance，但 VSCode 不会在构造失败前触发断点。
真正可中断的位置必须落在 http.Server 实例创建之后、且 io 实例已初始化完成的生命周期中，比如：
-
server.listen(3000)行 —— 确保服务真正启动 -
io.on('connection', ...)回调内部 —— 这才是 WebSocket 握手后实际执行逻辑的地方 -
socket.on('message', ...)内部 —— 双向通信的数据处理入口
别在 const io = new Server(server) 后立刻设断点，它只是初始化对象，不触发任何网络行为。
launch.json 中必须启用 --inspect 并正确 attach 到 Node 进程
VSCode 默认的 Node.js 调试配置（如 node: launch）对 Socket.io 服务端无效，因为它的 program 字段指向的是入口文件，但 Socket.io 依赖底层 TCP 连接监听，需要 V8 Inspector 协议主动暴露调试端口。
推荐做法是用 attach 模式，配合命令行显式启动：
- 终端运行：
node --inspect=9229 server.js（端口可自定义） -
launch.json中配置type: "node"+request: "attach"+port: 9229 - 确保
address为"localhost"，不要写成"127.0.0.1"（某些 WSL2 场景下 DNS 解析差异会导致连接失败）
如果用了 nodemon，需加 --inspect 参数：nodemon --inspect=9229 server.js，否则热重载后调试器会断连。
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
跨端调试时，前端断点和后端断点无法联动？检查是否启用了复合调试（compound）
WebSocket 通信链路天然跨进程：浏览器 JS 执行 socket.emit() → 网络传输 → Node.js 接收 socket.on()。想实现“前端发消息，后端自动停在对应 handler”，必须启用 VSCode 2026 的复合调试能力。
在 .vscode/launch.json 中定义 compounds，例如：
{
"configurations": [
{
"type": "pwa-chrome",
"request": "launch",
"name": "Frontend",
"url": "http://localhost:3000",
"webRoot": "${workspaceFolder}"
},
{
"type": "node",
"request": "attach",
"name": "Backend",
"port": 9229,
"address": "localhost"
}
],
"compounds": [
{
"name": "Full-stack WebSocket",
"configurations": ["Frontend", "Backend"],
"stopOnEntry": false
}
]
}
启动该 compound 后，VSCode 2026 的 vscode-debug-bridge 会自动同步两个端的断点状态，但注意：
- 前端断点需设在
socket.emit()调用行，而非new WebSocket()或连接建立处 - 后端断点必须设在
socket.on('xxx', () => { ... })的回调函数第一行，不能设在事件注册语句本身 - 若使用 Socket.io 命名空间或房间广播，断点位置要匹配实际触发路径（如
io.to('room1').emit()不会触发socket.on()，而是触发接收方的socket.on()）
断点命中但变量显示 undefined？检查 source map 和模块解析路径
Socket.io v4.7+ 默认启用 ESM 支持，而 Node.js 的 --inspect 对 ESM 的 source map 支持仍不稳定。常见现象：断点能停，但 socket、io 或自定义参数显示 undefined 或 Cannot access 'xxx' before initialization。
解决方法优先级排序：
- 确认
server.js是 CommonJS（require）风格，避免混用import和require - 在
launch.json的attach配置中添加："sourceMaps": true和"outFiles": ["${workspaceFolder}/dist/**/*.js"]（如果你用了 TypeScript 编译） - 禁用
node_modules中的 source map：在launch.json加"skipFiles": ["<node_internals>/**","**/node_modules/**"]</node_internals> - 避免在
socket.on()回调里直接解构高阶对象（如{ data } = msg），改用完整变量名再取值，防止 V8 优化导致调试器无法映射
真实调试中，最易被忽略的是：WebSocket 连接复用导致的 socket 实例复用。同一个 socket.id 可能在多次连接中重复出现，但 socket 对象本身已被销毁重建——断点停住时看到的 socket 是新实例，旧实例上的属性（如 socket.username）不会自动继承。
