Serverless架构下ExpressJS+TypeScript应用在VSCode中无法触发断点的求助

我之前碰到过一模一样的问题，经过几次调试验证，整理出以下适配你当前配置的解决方案：

1. 修正tsconfig.json的rootDir配置 #

你当前rootDir设为./，这会导致生成的.map源映射文件记录的源文件路径包含冗余的上级目录，VSCode无法精准关联到本地的.ts文件。修改为：

{
  "compilerOptions": {
    // 其他配置保持不变
    "rootDir": "./src" // 替换原来的"./"
  }
}

这个调整让编译时以src目录作为源码根目录，生成的源映射路径会直接指向src下的TypeScript文件，避免路径匹配混乱。

2. 优化launch.json调试配置 #

针对你的launch配置做几个关键调整，确保VSCode正确解析源映射：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "API Debug",
      "type": "node",
      "request": "launch",
      "cwd": "${workspaceRoot}/api",
      "runtimeExecutable": "node",
      "runtimeVersion": "14.17.0",
      "runtimeArgs": ["--lazy"],
      "skipFiles": ["<node_internals>/**"],
      "args": [
        "offline",
        "--noPrependStageInUrl",
        "--inspect" // 添加该参数，强制开启调试检查模式
      ],
      // 改用serverless的js入口文件，避免shell脚本的路径解析问题
      "program": "${workspaceRoot}/api/node_modules/serverless/bin/serverless.js",
      "console": "integratedTerminal",
      "sourceMaps": true,
      "smartStep": true, // 开启后自动跳过编译生成的冗余代码，直接定位源码
      "stopOnEntry": false,
      "outFiles": [
        "${cwd}/.build/src/**/*"
      ],
      "protocol": "inspector",
      "env": {
        "NODE_ENV": "development"
      },
      "autoAttachChildProcesses": true,
      // 强制映射源文件路径，避免路径不匹配
      "sourceMapPathOverrides": {
        "src/*": "${workspaceRoot}/api/src/*",
        "../src/*": "${workspaceRoot}/api/src/*",
        "*": "${workspaceRoot}/api/.build/*"
      }
    }
  ]
}

3. 确认serverless.yaml的handler路径 #

确保handler指向编译后的文件（serverless-plugin-typescript会自动处理，但明确配置更稳妥）：

functions:
  express:
    handler: .build/src/index.handler # 替换原来的src/index.handler
    # 其他配置保持不变

4. 清理旧编译文件并重新构建 #

删除.build目录，然后重新启动调试（serverless-plugin-typescript会自动重新编译）：

cd api
rm -rf .build
# 直接启动调试即可，插件会自动完成编译

完成以上调整后，重启VSCode调试器，应该就能在TypeScript源码中正常触发断点了。

内容的提问来源于stack exchange，提问作者James Parker