断点不触发是因为错误未传递到Koa错误中间件：需检查前置中间件是否提前return、解析中间件是否拦截请求、launch.json配置是否正确指向编译后JS文件、是否启用未捕获异常断点、skipFiles是否屏蔽node_modules。

断点设在Koa异常处理中间件里却不触发？先看请求有没有走到那里

不是调试器坏了，是错误根本没传到你的

app.use((err, ctx, next) => { ... })</p>
<ul>
<li>检查是否在它之前就提前 <code>return

了——比如鉴权中间件写了 ctx.status = 401; ctx.body = 'unauthorized'; return;，后续所有中间件（包括错误处理）都不会执行

确认 express.json() 或 koa-body 这类解析中间件没因格式错误直接抛出 400，导致请求链在入口就中断

用 curl -v http://localhost:3000/xxx 触发一个明确会出错的请求（比如发个空 body 给需要 JSON 的接口），同时在第一个日志中间件里加 console.log('→', ctx.method, ctx.path)，没输出就说明连入口都没进

launch.json 的 program 必须指向可运行的 .js，不是 .ts 也不是 .mjs

VSCode 不会编译 TypeScript，也不原生支持 ESM 的 import 语法。写成 "program": "${workspaceFolder}/src/app.ts" 或 "program": "${workspaceFolder}/index.mjs" 都会静默失败：进程启动了，但断点永远灰掉。

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• TypeScript 项目：确保 tsconfig.json 启用了 "sourceMap": true 和 "outDir": "./dist"，然后把 program 指向 "${workspaceFolder}/dist/app.js"
• ESM 项目：Node ≥ 18.17 + "type": "module" 在 package.json 中，program 可以是 .mjs，但别手动加 --loader 参数——VSCode 自动注入 --inspect 时会冲突
• 用 npm start 启动的项目，别硬配 program；改用 "runtimeExecutable": "npm", "args": ["start"]，避免入口和实际运行脱节

想让 throw 立刻停住？必须开 Uncaught Exceptions + Uncaught Promise Rejections

Koa 里 throw new Error('xxx') 是同步未捕获异常，但 Promise.reject(new Error()) 属于异步拒绝，默认不中断——这两个开关是独立的，缺一不可。

• 打开「运行和调试」面板 → 「断点」区域 → 点击「+」→ 分别勾选 Node.js: Uncaught Exceptions 和 Node.js: Uncaught Promise Rejections
• 注意：try { throw new Error() } catch (e) { } 这类已捕获异常，不会触发 Uncaught Exceptions；如需中断，得临时开启「Pause on caught exceptions」或在 launch.json 加 "exceptions": { "caught": true }，但会干扰正常流程
• 依赖包里的 Promise 错误（比如 axios.get() 失败后没 .catch()），同样依赖 Uncaught Promise Rejections 开关，不是靠改代码能解决的

进 node_modules 看源码？先删掉 skipFiles 里的屏蔽规则

断点打在 node_modules/koa-router 里是空心圆？大概率是 launch.json 的 skipFiles 默认跳过了所有第三方代码。

• 删掉整个 skipFiles 字段，或至少移除 "**/node_modules/**" 这一行
• 更安全的做法：保留默认跳过，只放行你要查的包，比如加一条 "!**/node_modules/koa-router/**" —— 注意顺序，第一条匹配即生效
• 进了 node_modules 却停在 lib/index.js 而不是源码？说明该包没发布 .map 文件，或 sourceMap 链路断了；别指望能直接跳转，只能看编译后代码

Koa 的错误中间件本质是“兜底”，但它的触发前提是错误真被抛到了洋葱外层。调试时最容易忽略的，是错误在某一层就被吞掉、或者压根没走到 Koa 的调度链里——这时候再调 launch.json 也没用。