断点不触发是因为错误未传递到koa错误中间件：需检查前置中间件是否提前return、解析中间件是否拦截请求、launch.json配置是否正确指向编译后js文件、是否启用未捕获异常断点、skipfiles是否屏蔽node_modules。
断点设在Koa异常处理中间件里却不触发？先看请求有没有走到那里
不是调试器坏了，是错误根本没传到你的
app.use((err, ctx, next) => { ... })
- 检查是否在它之前就提前
return 了——比如鉴权中间件写了 <code>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链路断了；别指望能直接跳转，只能看编译后代码
