Windows主机VSCode远程调试ARM Linux设备报错求助

环境配置 #

Windows主机VSCode launch.json配置 #

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "gdb",
            "request": "attach",
            "name": "gdb",
            "executable": "${workspaceRoot}\myprogram\myprogram ",
            "stopAtConnect": true,
            "target": "192.168.xxx.xxx:2000",
            "remote": true,
            "cwd": "${workspaceRoot}/myprogram", 
            "gdbpath": "C:\msys64\mingw64\bin\gdb-multiarch.exe",
            "debugger_args": ["-iex", "set osabi none"],
        }
    ]
}

注：JSON语法中路径需使用双反斜杠\\，当前配置里的单反斜杠会导致路径解析错误。

目标ARM Linux设备信息 #

debarm:~# gdbserver --version                                         
GNU gdbserver (GDB) 7.0.1-debian                                      
Copyright (C) 2009 Free Software Foundation, Inc.                     
gdbserver is free software, covered by the GNU General Public License.
This gdbserver was configured as "arm-linux-gnueabi"                  
debarm:~# gdbserver :2000 --attach 1966                               
Attached; pid = 1966                                                  
Listening on port 2000                                                
Remote debugging from host 192.168.xxx.xxx

遇到的错误 #

• 使用gdb-multiarch.exe或ARM官网arm-none-eabi-gdb.exe时，单步调试触发warning: Remote failure reply: E01
• 使用Linaro arm-linux-gnueabi-gdb.exe时，出现Error while reading shared library symbols for target:/lib/ld-linux.so.3

问题根源与解决建议 #

1. GDB与gdbserver版本严重不匹配（核心问题） #

目标设备的gdbserver是2009年发布的7.0.1老旧版本，而你使用的Windows端GDB工具版本远高于此。GDB调试协议在不同大版本间存在兼容性差异，版本差过大直接导致调试通信失败，触发E01错误。

2. 错误选择GDB工具类型 #

arm-none-eabi-gdb.exe是针对裸机、RTOS场景的调试工具，不支持Linux用户态进程的系统调用、共享库等调试特性，用来调试Linux程序必然出现兼容性问题。

3. 共享库符号加载失败的原因 #

Linaro的arm-linux-gnueabi-gdb.exe是适配Linux用户态的正确工具，但符号加载错误仍源于版本不匹配；其次可能是主机缺少目标设备的共享库文件，导致GDB无法解析符号。

具体解决步骤 #

• 升级目标设备的gdbserver：下载与Windows端GDB版本接近的arm-linux-gnueabi-gdbserver（比如主机GDB是10.x就选10.x版本），替换设备上的老旧版本，版本越接近兼容性越好。
• 修正launch.json路径：将配置中的单反斜杠改为双反斜杠，比如${workspaceRoot}\\myprogram\\myprogram、C:\\msys64\\mingw64\\bin\\gdb-multiarch.exe，确保路径能被正确解析。
• 使用正确的GDB工具：保留Linaro的arm-linux-gnueabi-gdb.exe，放弃arm-none-eabi-gdb.exe。
• 配置共享库搜索路径：若升级gdbserver后仍有符号问题，从设备拷贝/lib/下的相关库文件到主机目录，在launch.json中添加setupCommands指定搜索路径：

  "setupCommands": [
      {"text": "set solib-search-path C:\\your\\path\\to\\device-libs"}
  ]
  

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