Azure App Service中VS Code Node.js远程调试断点无法激活

以下是针对该问题的排查和解决步骤：

• 确保本地与远程代码完全同步
  远程运行的代码必须和本地调试的代码完全一致，包括文件内容、依赖版本、编译产物（如TypeScript转译后的JS文件）。检查是否有本地未提交的改动，或自动部署流程（如GitHub Actions）是否部署了正确的分支/版本。

• 配置正确的启动调试参数
  在Azure门户的App Service「配置」→「通用设置」中，确认启动命令包含Node.js调试参数：

  • 直接启动脚本：node --inspect server.js
  • 若用npm start，需确保package.json的start脚本包含--inspect，比如："start": "node --inspect server.js"

• 检查VSCode调试配置（launch.json）
  验证launch.json中的路径映射是否正确，示例配置如下：

  {
    "version": "0.2.0",
    "configurations": [
      {
        "type": "node",
        "request": "attach",
        "name": "Attach to Azure App Service",
        "port": 9229,
        "address": "localhost",
        "localRoot": "${workspaceFolder}",
        "remoteRoot": "/home/site/wwwroot",
        "skipFiles": ["<node_internals>/**"]
      }
    ]
  }
  

  重点确认localRoot（本地项目根目录）和remoteRoot（远程App Service代码路径，默认是/home/site/wwwroot）的文件结构完全匹配。

• 验证Node.js版本与端口连通性

  • 在Azure门户的App Service「配置」→「应用设置」中，确认WEBSITE_NODE_DEFAULT_VERSION使用支持调试的LTS版本（如18.x、20.x）。
  • 调试会话启动后，尝试用telnet localhost 9229测试本地端口连通性，确保没有代理或防火墙阻止连接。

• 清理缓存并重置调试环境

  • 停止当前调试会话，关闭VSCode，备份后删除.vscode/launch.json，重新通过Azure Explorer生成调试配置。
  • 在Azure门户重启App Service实例，清除远程缓存后再次启动调试。

• TypeScript项目额外排查

  • 确保tsconfig.json中sourceMap设置为true，编译时生成的.map文件已部署到远程。
  • 在launch.json中添加outFiles配置指向编译后的JS文件路径，比如："outFiles": ["${workspaceFolder}/dist/**/*.js"]

内容的提问来源于stack exchange，提问作者Zeid S.