VSCode中无法启动ST-LINK GDB服务器/调试STM32开发板问题

环境信息 #

• 操作系统：Windows 11
• 开发板：STM32F407VG

问题描述 #

此前通过Microsoft Embedded Tools扩展将ST项目导入VSCode，编译调试均正常。更新STM32CubeIDE至1.17版本后，重新导入项目，编译功能正常，但启动调试时弹出错误：Unable to start debugging. Debug server process failed to initialize.。已更新ST-Link固件，问题仍未解决。

Debug Console 输出 #

1: (133) -
1: (138) -
1: (138) ->STMicroelectronics ST-LINK GDB server. Version 7.9.0
1: (138) ->Copyright (c) 2024, STMicroelectronics. All rights reserved.
1: (138) -
1: (138) ->Starting server with the following options:
1: (138) ->        Persistent Mode            : Disabled
1: (138) ->        Logging Level              : 1
1: (138) ->        Listen Port Number         : 3333
1: (138) ->        Status Refresh Delay       : 15s
1: (139) ->        Verbose Mode               : Disabled
1: (139) ->        SWD Debug                  : Enabled
1: (139) -
1: (175) ->Waiting for debugger connection...
1: (10129) <-logout
1: (10139) Send Event AD7MessageEvent

Launch.json 配置 #

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch",
      "type": "cppdbg",
      "request": "launch",
      "cwd": "${workspaceFolder}",
      "program": "${command:cmake.launchTargetPath}",
      "MIMode": "gdb",
      "miDebuggerPath": "${command:vscode-embedded.st.gdb}",
      "miDebuggerServerAddress": "localhost:3333",
      "debugServerPath": "${command:vscode-embedded.st.gdbserver}",
      "debugServerArgs": "--stm32cubeprogrammer-path ${command:vscode-embedded.st.cubeprogrammer} --swd --port-number 3333",
      "serverStarted": "Waiting for connection on port .*\\.\\.\\.",
      "stopAtConnect": true,
      "postRemoteConnectCommands": [
        {
          "text": "load build/debug/build/002LED.elf"
        }
      ],
      "logging": {
        "engineLogging": true
      },
      "preLaunchTask": "Build",
      "svdPath": "${command:vscode-embedded.st.svd}/STM32F407.svd"
    }
  ]
}

解决步骤 #

1. 手动指定STM32CubeProgrammer路径 #

STM32CubeIDE更新后，VSCode扩展可能无法自动识别工具路径。将debugServerArgs中的${command:vscode-embedded.st.cubeprogrammer}替换为STM32CubeProgrammer的绝对路径（根据实际安装目录调整）：

"debugServerArgs": "--stm32cubeprogrammer-path \"C:/STMicroelectronics/STM32CubeIDE_1.17.0/STM32CubeProgrammer/bin/STM32_Programmer_CLI.exe\" --swd --port-number 3333",

2. 更新Microsoft Embedded Tools扩展 #

打开VSCode扩展市场，找到Microsoft Embedded Tools，安装最新版本，确保扩展适配STM32CubeIDE 1.17。

3. 指定兼容的GDB路径 #

使用STM32CubeIDE自带的GDB替换扩展默认路径，修改miDebuggerPath：

"miDebuggerPath": "C:/STMicroelectronics/STM32CubeIDE_1.17.0/STM32CubeIDE/plugins/com.st.stm32cube.ide.mcu.externaltools.gnu-tools-for-stm32.12.3.rel1.win32_1.0.0.202309141206/tools/bin/arm-none-eabi-gdb.exe",

4. 检查端口占用 #

执行以下命令查看3333端口是否被占用：

netstat -ano | findstr :3333

若有占用，结束对应进程后重新调试。

5. 调整serverStarted匹配规则 #

修改serverStarted为更宽松的匹配字符串，确保GDB Server启动后能被正确识别：

"serverStarted": "Waiting for debugger connection",

6. 关闭调试引擎日志 #

暂时关闭engineLogging避免干扰调试流程：

"logging": {
  "engineLogging": false
},

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