基于VSCode的Node项目配合Koa中间件机制进行异常兜底捕获环境测试

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

其实，断点没触发，十有八九不是调试器出了毛病，而是错误压根儿就没传到你的错误处理中间件里。它可能在某处就被悄悄吞掉了。先别急着调 launch.json，先顺着请求链捋一遍：

• 看看前面的中间件有没有提前 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" 写进去，结果进程是启动了，但断点永远灰着一一这就是典型的静默失败。

• 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 也没用。