基于VSCode的Node项目配合Koa中间件机制进行异常兜底捕获环境测试
Koa错误处理中间件断点不触发，常因错误被中途吞掉或未进入调度链。需检查请求链中中间件提前返回、解析中间件中断等。配置调试时，program应指向编译后的.js，TS需sourceMap和outDir，ESM需Node≥18.17。开启UncaughtExceptions和PromiseRejections开关。若需调试node_modules，移除skip
断点设在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 也没用。
正软商城本月促销专区，汇集办公、设计、安全、影音、系统工具及AI软件等正版软件优惠活动，提供限时折扣、特价授权和优惠购买信息，活动库存及价格以页面实时展示为准。
正软商城装机必备专区，精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件，帮助用户快速完成新电脑软件配置。
正软商城Windows软件专区，汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件，提供软件介绍、系统要求、正版授权及购买下载服务。
正软商城macOS软件专区，精选适用于Mac电脑的办公、设计、影音、效率、开发和系统工具，提供软件功能介绍、macOS兼容版本、正版授权及购买下载服务。
正软商城iOS软件专区，精选适用于iPhone和iPad的办公、学习、影音、设计、效率及AI应用，提供功能介绍、适用设备、系统要求和正版获取方式等信息。
正软商城AI软件专区，汇集AI写作、AI绘画、AI视频、AI办公、AI编程、AI翻译、智能客服和数据分析等人工智能工具，提供功能介绍、适用平台、收费方式及正版购买信息。
正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法，同时介绍常用PDF软件和工具的使用技巧。
赤友清理大师是一款为 Mac 设计的智能清理优化工具，可精准扫描垃圾、大文件、重复文件等，释放磁盘空间。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
极度公式是一款跨平台专业LaTeX公式识别编辑软件，支持OCR公式识别和多平台编辑。和使用说明，避免使用，享受完整功能与稳定支持。做扫描整理、文字提取和表格转换时，它能把识别后的处理步骤接得更顺，资料录入这类场景会省下不少时间。
一款文字处理软件，一种订阅式的跨平台办公软件，基于云平台提供多种服务，通过将 Excel 和 Outlook 等应用与 OneDrive 和 Microsoft Teams 等强大的云服务相结合，Office 365 可让任何人使用任何设备随时随地创建和共享内容。
Wise Folder Hider Pro 是一款专业级文件和文件夹隐藏加密软件，为私密数据添加多重保护。高频操作更强调就近处理，浏览、整理和跨目录移动文件时，来回切换和重复点击都会少很多。
CodeExpander 是一款快捷短语输入增强工具，通过键入缩写自动展开为自定义文段，提升工作效率。任务管理和过程控制会更完整，持续下载、批量同步或需要稳定传输流程的场景会更适合它。
Mountain Duck 是一款能将多个网盘挂载到本地的工具，像本地磁盘一样使用网盘。清理链路的完整性会更好一些，做应用卸载、残留处理和空间整理时，通常能少走很多手动排查步骤。
