VS Code+Docker交叉编译远程调试无源码、符号显示问题求助

问题场景 #

本地VS Code连接Docker容器后，尝试附加到虚拟机（VM）中运行的my_app进程：

1. VM中执行命令：gdbserver --attach localhost:2001 7334（7334为目标进程ID）
2. VS Code中配置C/C++(gdb) Attach的launch.json如下：

{
    "name": "(gdb) Attach",
    "type": "cppdbg",
    "request": "attach",
    "program": "${workspaceFolder}/my_app",
    "MIMode": "gdb",
    "useExtendedRemote": true,
    "setupCommands": [
        {
            "description": "Enable pretty-printing for gdb",
            "text": "-enable-pretty-printing",
            "ignoreFailures": true
        },
        {
            "description": "Set Disassembly Flavor to Intel",
            "text": "-gdb-set disassembly-flavor intel",
            "ignoreFailures": true
        },
        {
            "description": "Set sysroot ",
            "text": "set sysroot /path/to/sysroot",
            "ignoreFailures": true
        },
        {
            "description": "Auto-loading safe path",
            "text": "set auto-load safe-path /",
            "ignoreFailures": true
        },
        {
            "description": "Substitute path",
            "text": "set substitute-path /usr/src/debug/ /path/to/sysroot/usr/src/debug/",
            "ignoreFailures": true
        },
        {
            "description": "Substitute path",
            "text": "set substitute-path /usr/lib64/ /path/to/sysroot/usr/lib64",
            "ignoreFailures": true
        },                
        {
            "description": "Set solib",
            "text": "set solib-search-path ${workspaceFolder}/path_to_solibs/",
            "ignoreFailures": true
        }                            
    ],
    "miDebuggerPath": "/path/to/sysroot/gdb",
    "miDebuggerServerAddress": "10.1.1.1:2001"
}

当前问题：

• 已成功连接VM，确认符号加载，但断点无法触发暂停
• 手动暂停调试器后，无源码、符号、变量显示，调用栈异常

排查修复步骤 #

1. 修正gdbserver绑定地址 #

gdbserver --attach localhost:2001 7334中的localhost仅允许VM本地访问，而VS Code运行在Docker容器中，无法通过localhost访问VM的端口。需改为绑定VM的对外IP或0.0.0.0：

gdbserver --attach 0.0.0.0:2001 7334

同时确保VM的2001端口已开放，Docker容器能通过10.1.1.1:2001正常连通。

2. 验证sysroot与路径替换的正确性 #

• set sysroot /path/to/sysroot：必须是Docker容器内可访问的、与VM运行环境完全匹配的sysroot路径，包含对应架构的库和调试符号，不能使用VM本地路径。
• substitute-path配置：需将VM中的路径映射到Docker容器内的对应路径，例如VM中/usr/src/debug/对应容器内/opt/sysroot/usr/src/debug/，则修改为：

  "text": "set substitute-path /usr/src/debug/ /opt/sysroot/usr/src/debug/",
  

• solib-search-path：确保${workspaceFolder}/path_to_solibs/指向容器内存放my_app依赖库的目录，且库文件与VM中加载的版本一致。

3. 确认二进制文件一致性 #

VS Code中program字段指定的${workspaceFolder}/my_app必须与VM中运行的my_app是完全相同的二进制文件（编译时带-g调试符号，建议关闭优化-O0）。如果是交叉编译产物，需确保容器内的文件包含完整调试信息，且与VM中运行的版本无差异。

4. 匹配gdb与gdbserver版本 #

miDebuggerPath指定的容器内gdb版本，必须与VM中gdbserver的版本保持一致或兼容（建议同大版本），版本差异会导致调试协议不兼容，引发符号解析失败。

5. 添加remoteRoot路径映射 #

在launch.json中添加remoteRoot字段，指定VM中my_app的运行目录，帮助VS Code正确映射路径：

"remoteRoot": "/home/vm-user/my_app_dir"

6. 调试控制台手动验证符号加载 #

在VS Code调试控制台中执行以下gdb命令，排查符号加载问题：

• info files：查看是否正确识别my_app的可执行文件与符号表
• info sharedlibrary：检查依赖库的符号是否成功加载
• bt：查看调用栈是否能正常解析，若输出乱码或无有效信息，说明路径映射或sysroot配置错误

内容的提问来源于stack exchange，提问作者Ulises V.