VS Code远程调试Docker容器中Node.js Azure函数失败求助

问题根源分析 #

你遇到的错误核心是本地调试器无法正确映射容器内的文件路径到本地文件，具体问题点：

• launch.json中remoteRoot配置错误，容器内函数代码的实际路径是/home/site/wwwroot/dist/src/functions，你漏掉了/home前缀
• 本地路径使用Windows反斜杠容易导致解析问题，且${workspaceRoot}已被弃用，建议使用更标准的${workspaceFolder}
• 调试器错误地尝试从本地C盘路径读取容器内的source map文件，需要通过路径覆盖修正映射逻辑

步骤1：修正launch.json配置 #

更新调试配置，修正路径映射并添加source map路径覆盖规则：

{
    "configurations": [
        {
            "type": "node",
            "request": "attach",
            "name": "Docker: Attach to Node",
            "remoteRoot": "/home/site/wwwroot/dist/src/functions",
            "localRoot": "${workspaceFolder}/src/functions",
            "port": 9233,
            "address": "localhost",
            "sourceMaps": true,
            "sourceMapPathOverrides": {
                "/home/site/wwwroot/dist/src/*": "${workspaceFolder}/src/*",
                "/azure-functions-host/*": "${workspaceFolder}/node_modules/azure-functions-core-tools/*"
            }
        }
    ]
}

关键修改说明： #

• remoteRoot：补全/home前缀，严格匹配容器内代码的实际存储路径
• localRoot：改用${workspaceFolder}并统一使用正斜杠，避免跨平台路径解析冲突
• sourceMapPathOverrides：强制将容器内的两类路径映射到本地对应位置，直接解决source map找不到的错误

步骤2：确认TypeScript配置生成Source Map #

检查项目根目录的tsconfig.json，确保sourceMap字段设置为true，这样构建时才会生成对应的.map文件：

{
    "compilerOptions": {
        "sourceMap": true,
        // 其他原有配置...
    }
}

步骤3：重新构建并启动容器 #

1. 重新构建Docker镜像，确保source map文件被正确复制到容器内：

docker build -t af-docker .

2. 保持原有端口映射和调试环境变量，重新启动容器：

docker run -p 8080:80 -p 9233:9233 -e NODE_OPTIONS=--inspect=0.0.0.0:9233 -it af-docker

步骤4：验证调试 #

启动VS Code调试（F5）后：

• 容器输出显示Debugger attached.即表示连接成功
• 现在可以在本地TypeScript文件中设置断点，触发HTTP请求（如访问http://localhost:8080/api/HttpExample），断点即可正常命中

内容的提问来源于stack exchange，提问作者Ladislav Margai