Guard断点不触发主因是未运行编译后dist/main.js且模块未正确注册；需确保start:debug脚本执行nest build后运行node --inspect-brk dist/main.js，launch.json指向dist/main.js，tsconfig启用sourceMap与outDir，并验证@Injectable()、@UseGuards()及依赖注入完整。
Guard执行流程不触发断点？检查是否在编译后路径运行
VSCode 里 Guard 的 @UseGuards() 断点不命中，90% 是因为没跑 dist/main.js，而是直接用 ts-node src/main.ts 启动。Node 调试器只认编译后的 JS + sourceMap，ts-node 动态编译会绕过断点映射。
- 确认
package.json中"start:debug"是"nest build && node --inspect-brk dist/main.js"，不是ts-node相关命令 -
launch.json的runtimeExecutable设为"node"，program指向"${workspaceFolder}/dist/main.js" -
tsconfig.json必须同时启用"sourceMap": true和指定"outDir": "dist"，缺一不可 - 删掉
dist/目录再nest build一次，避免旧.js.map文件残留导致映射错乱
Guard类里打的断点全灰？验证模块加载与装饰器注册
Guard 不是定义了就能被调用——它必须被 Nest 容器识别并注入到请求生命周期中。断点变空心，往往意味着该 Guard 根本没被加载进模块上下文。
Json Schema Toolkit
下载
使用 JSON Schema 验证 JSON 数据，从示例 JSON 生成 schema，并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。
- 确保 Guard 类用
@Injectable()装饰，并在对应模块的providers数组中显式声明（或通过useGlobalGuards()全局注册） - 检查控制器方法上是否正确使用了
@UseGuards(JwtAuthGuard)，注意拼写和导入路径是否指向编译后位置 - 如果 Guard 依赖其他服务（如
JwtService），确认这些依赖已在模块的providers或imports中提供，否则 Nest 无法实例化它 - 在 Guard 的
canActivate()方法第一行加console.log('guard triggered')，若无输出，说明未进入生命周期——优先排查模块结构而非调试配置
JWT校验失败但断点跳过？注意异步逻辑与 RxJS 处理时机
Nest 的 Guard 返回 boolean 或 Observable<boolean></boolean>，而 JWT 验证通常异步（如调用 jwtService.verify()）。断点“跳过”，其实是你打断点的位置不在实际执行流上。
- 不要在
canActivate()函数体开头打断点，而要在return this.jwtService.verify(token).then(...)或pipe(map(...))内部设断点 - 若用
async/await，确保canActivate声明为async，且返回Promise<boolean></boolean>；否则 Nest 会当作同步函数处理，可能吞掉异常或提前返回false - RxJS 版本差异会影响
pipe执行时机：Nest v10+ 默认用 RxJS 7+，tap()不会中断流，map()才是转换关键点——断点应落在map回调内 - 错误堆栈里出现
Uncaught Promise rejection？说明 JWT 验证抛错但没被 Guard 的catchError捕获，此时断点根本不会走到后续逻辑
想看Guard拦截全过程日志？别只靠console.log，得结构化输出
单纯 console.log 在多层级微服务下难以关联请求上下文，VSCode 本身不聚合跨进程日志。要真正诊断 Guard 是否生效、为何拒绝、在哪一步卡住，必须注入 trace_id 并打 JSONL 日志。
- 在
canActivate()开头提取request.headers['authorization']和request.id（需先配express-request-id中间件） - 输出格式统一为：
{"time":"2026-07-06T10:28:00.123Z","level":"DEBUG","service":"auth","trace_id":"abc123","msg":"guard started","token_present":true} - 验证失败时，不要只写
console.error('Invalid token')，而要提取err.name、err.message、err.response?.status打成 ERROR 级结构化日志 - 配合 VSCode 插件
LogLens，开启"loglens.enableJsonLog": true，就能按trace_id聚合所有 Guard、Controller、Service 的日志行
