nestjs微服务必须通过--inspect+attach模式调试，因launch模式无法处理其非http启动特性；需在main.ts中显式调用createmicroservice()和await microservice.listen()，并确保sourcemap、outfiles路径及端口配置正确。
直接说结论：NestJS 微服务不能靠 npm run start 或默认 launch.json 的 program 字段启动调试——它必须走 --inspect + attach 模式，且微服务入口（如 main.ts）里得显式调用 createMicroservice()。
为什么 NestJS 微服务在 VSCode 里断点不生效
普通 HTTP 服务调试时，VSCode 可以用 launch 模式直接运行 dist/main.js；但微服务（TCP、Redis、Kafka 等）启动后不监听 HTTP 端口，node --inspect 启动后若没立刻进入事件循环（比如卡在连接 broker 或等待注册），VSCode 的调试器会超时断连。更常见的是：你写了 app.listen() 却漏掉 microservice.listen()，进程根本没真正“跑起来”，断点自然不触发。
- 微服务模块未被
@Module的imports引入，NestApplication根本不加载它 -
main.ts里只调用了app.init()，没调microservice.listen()或await microservice.listen() - 使用
nest start --debug但没指定端口，或端口被占用导致--inspect绑定失败 -
tsconfig.json中"sourceMap": true缺失，或outDir和launch.json中的outFiles路径不一致
正确的 launch.json 配置（attach 模式）
不要用 launch 模式去“启动”微服务进程——改用 attach，让 VSCode 去连接已启动的、带 --inspect 的 Node 进程。这是最稳的方式。
-
type必须是node，不是pwa-node（旧版插件兼容性差） -
request设为attach，不是launch -
port要和启动命令里的--inspect=9229完全一致（默认是 9229） -
outFiles写成["${workspaceFolder}/dist/**/*.js"]，不能漏掉**，否则子目录下的microservices/*.js找不到源码映射 -
sourceMaps设为true，且确保tsconfig.json里有"sourceMap": true, "outDir": "dist"
示例 launch.json 片段：
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
{
"type": "node",
"request": "attach",
"name": "Attach to Microservice",
"port": 9229,
"outFiles": ["${workspaceFolder}/dist/**/*.js"],
"sourceMaps": true,
"skipFiles": ["<node_internals>/**"]
}</node_internals>
启动微服务的 npm script 必须带 --inspect
不能只写 nest start 或 node dist/main.js——必须显式加 --inspect 参数，并保证端口开放、不被复用冲突。
- 推荐脚本：
"start:debug": "node --inspect=0.0.0.0:9229 dist/main.js"（注意是dist/main.js，不是src/main.ts） - 如果用
nestCLI，确保package.json里有"start:debug": "nest start --debug 9229"，且nest版本 ≥ 10.3.0（旧版不支持微服务调试） - Windows 用户若报
Cannot connect to runtime process，把0.0.0.0换成127.0.0.1，或关掉防火墙临时测试 - 启动前先
npm run build，确保dist/下有编译后的微服务代码（比如dist/microservices/tcp.service.js）
微服务入口 main.ts 的关键写法
很多断点不命中，根源不在配置，而在 main.ts 本身没真正“启动”微服务实例。
- 必须显式创建微服务应用：
const microservice = app.connectMicroservice(...) - 必须调用
await microservice.listen()（或microservice.listen().then(...)），不能只声明不执行 - 如果同时跑 HTTP + 微服务，要
await app.listen()和await microservice.listen()都完成，否则进程可能提前退出 - 检查
app.connectMicroservice()的配置对象，比如 TCP 地址是否写错（{ port: 3001 }而不是{ host: 'localhost', port: 3001 }）
典型正确结构：
async function bootstrap() {
const app = await NestFactory.create(AppModule);
// HTTP 服务（可选）
await app.listen(3000);
// 微服务必须 listen 才真正启动
const microservice = app.connectMicroservice({
transport: Transport.TCP,
options: { port: 3001 },
});
await microservice.listen(); // ← 这行不能少
}
bootstrap();
微服务调试真正的难点不在配置文件，而在于确认进程确实在跑、事件循环已激活、且源码映射路径和编译输出完全对齐——漏掉任意一环，断点就只是灰色圆点。
