VSCode调试Node时Ctrl+C不触发优雅停机，因调试器拦截SIGINT；应改用SIGTERM监听+externalTerminal，或切换至attach模式并启用--inspect。
VSCode调试Node应用时，Ctrl+C默认不触发优雅停机，因为调试器拦截了SIGINT；真正可行的方案是改用SIGTERM监听 + externalTerminal，或切换到attach模式并显式启动--inspect。
为什么Ctrl+C在调试中收不到SIGINT
VSCode调试器（尤其是type: "node"）会接管SIGINT信号，将其转为“终止调试会话”，根本不会透传给你的Node进程。哪怕你写了process.on('SIGINT', cleanup)，它也永远不会执行。
-
process.exit()会跳过所有清理逻辑，直接杀进程——这不是优雅停机，是强制断电 - 使用
nodemon时，默认转发的是SIGUSR2，不是SIGINT，需额外加--signal SIGINT - 即使监听了
SIGINT，如果server.close()没await，后续process.exit()仍可能提前执行
用SIGTERM + externalTerminal模拟真实关机
SIGTERM不被VSCode调试器拦截，是最稳妥的调试期信号选择。配合externalTerminal可确保信号完整送达。
- 在
launch.json中设"console": "externalTerminal"，避免集成终端吞掉信号 - 代码里监听
process.on('SIGTERM', async () => { await cleanup(); process.exit(0); }) - 调试启动后，在外部终端运行
kill -TERM $(pgrep -f 'node.*server.js')（macOS/Linux）或Get-Process -Name node | Where-Object {$_.Path -like "*server.js*"} | Stop-Process -Force（Windows） - 不要在
cleanup()里直接process.exit()，留出异步操作时间；超时兜底可用setTimeout(() => process.exit(1), 5000)
改用attach模式并启用pwa-node
如果你坚持用Ctrl+C，必须放弃launch模式，改走attach：让Node自己启动、自己收信号，VSCode只负责连接调试。
- 终端手动启动：
node --inspect=9229 --trace-warnings ./src/server.js -
launch.json配"type": "pwa-node"（VSCode 1.80+ 推荐）、"request": "attach"、"port": 9229 - 务必移除
runtimeArgs中任何--signal参数，它们可能干扰信号路由 -
process.on('SIGINT', ...)必须在server.listen()之后注册，否则监听器还没挂上进程就退出了
调试时验证停机逻辑是否真被执行
别等上线才发现db.close()没调用。本地调试阶段就要能复现、能观察、能打断点。
- 在
gracefulShutdown函数第一行加debugger语句，而不是只靠console.log - 临时mock耗时操作：
db.close()→await new Promise(r => setTimeout(r, 100))，聚焦流程而非依赖 - 检查VSCode底部状态栏是否显示「调试正在运行」，否则
debugger语句会被忽略 - 若断点不命中，先确认
server.close()是否await，再确认process.on是否在listen之后注册
最容易被忽略的是：server.close()本身不阻塞，必须await其返回的Promise；Koa/Express的server.close()返回的是http.Server实例，但关闭完成事件需要手动监听server.on('close', ...)或用new Promise包装——这点在调试中极易漏掉，导致process.exit()抢在连接真正释放前执行。
