LoopBack 接口应用在 VSCode 中无法调试的根本原因是 Node.js 进程未启用 inspector 且 launch.json 缺少适配：必须添加 --inspect 参数启动（如 node --inspect ./dist/index.js 或 ts-node --inspect -r ts-node/register ./src/index.ts），并在 launch.json 中匹配配置——JS 项目用 "request": "attach" + "port": 9229，TS 项目推荐 "request": "launch" + "runtimeExecutable": "npx" + "runtimeArgs" 调用 ts-node --inspect，并设置 "outFiles" 显式声明生成路径；同时需注意 LoopBack 异步初始化、依赖注入延迟实例化及热重载冲突等导致断点失效的特有行为。
LoopBack 接口应用在 VSCode 中能直接运行，但默认配置下无法调试——根本原因是 Node.js 进程未启用 inspector，且 VSCode 的 launch.json 缺少对应调试适配。
Node 启动必须加 --inspect 参数
LoopBack 项目（如 LoopBack 4）通常用 npm start 或 ts-node 启动，但这些命令默认不开启调试端口。VSCode 的调试器需要连接到一个正在监听 127.0.0.1:9229（或自定义端口）的 V8 inspector 实例。
- 检查
package.json中的start脚本：若为node ./dist/index.js，应改为node --inspect ./dist/index.js - 若用
ts-node（开发时常见），改写为ts-node --inspect -r ts-node/register ./src/index.ts - 避免只写
--inspect-brk：它会让进程在第一行暂停，但 LoopBack 初始化阶段有异步加载逻辑，过早中断可能卡在模块解析中 - 端口冲突时可指定：
--inspect=0.0.0.0:9230，但仅限本地调试；生产环境切勿开放0.0.0.0
launch.json 必须匹配启动方式
VSCode 不会自动识别你用什么命令启的服务。必须手动配置 .vscode/launch.json，且类型（type）、请求模式（request）和目标（program 或 runtimeExecutable）要与实际一致。
- 对已编译的 JS：用
"type": "node"+"request": "attach"，并确保"port": 9229与启动参数一致 - 对 TS 源码直跑：推荐
"request": "launch"，设"runtimeExecutable": "npx"，"runtimeArgs": ["ts-node", "--inspect", "-r", "ts-node/register", "${workspaceFolder}/src/index.ts"] - 漏掉
"outFiles"会导致断点不命中：TS 项目需显式声明生成 JS 路径，例如"outFiles": ["${workspaceFolder}/dist/**/*.js"] - 不要依赖自动端口发现——LoopBack 的
lb4 test或npm run dev若没传--inspect，VSCode 就连不上
LoopBack 特定行为导致断点“消失”的常见原因
LoopBack 4 使用依赖注入容器和生命周期钩子，源码执行顺序与文件结构不完全线性，断点打错位置就等于没打。
- 控制器方法里打断点有效，但
@inject注入的 Service 类构造函数里打点可能不触发——因为 LB 容器延迟实例化，首次调用才创建 - 路由未注册成功时，请求根本进不到控制器：检查
application.ts中是否调用了this.controller(XXXController) - 使用
@loopback/rest时，错误处理中间件（如Sequence）可能吞掉异常，导致断点后无日志——建议在sequence.ts的handleError头部加断点 - 热重载（如
nodemon）与调试器冲突：每次重启都会断开调试会话；改用ts-node-dev --inspect并在launch.json中设"restart": true
真正卡住的地方往往不是配置本身，而是 LoopBack 的异步初始化流程——比如 await app.boot() 内部加载多个 @loopback/boot 模块，期间任何 Promise rejection 都不会抛到顶层，也不触发断点，只能靠 console.log 或在 booter 类的 load() 方法里下断。
