M1 Mac上ESP32 GDB调试报错：dyld[]: missing symbol called

问题本质 #

这个报错是arm64架构Mac上，ESP-IDF配套的GDB工具链存在动态链接兼容性问题，导致启动时触发Abort trap。

修复方案 #

1. 用Rosetta 2运行终端 #

M1原生arm64环境对部分x86_64编译的GDB支持差，先切换到Rosetta模式：

• 找到「终端」应用，右键选「显示简介」
• 勾选「使用Rosetta打开」，重启终端后重新加载ESP-IDF环境：source $IDF_PATH/export.sh
• 再次启动GDB调试，多数情况下能解决问题

2. 手动编译arm64适配版GDB #

如果Rosetta无效，自己编译支持M1的GDB：

• 先装依赖：brew install gmp mpfr libmpc ncurses
• 下载和当前ESP-IDF配套的GDB源码（比如IDF v5.x对应GDB 12.x）
• 编译配置：

  ./configure --target=xtensa-esp32-elf --prefix=$HOME/esp-gdb-arm64 --with-python=no --disable-werror
  make -j$(sysctl -n hw.logicalcpu)
  make install
  

• 修改ESP-IDF工具链配置：打开$IDF_PATH/tools/cmake/toolchain-esp32.cmake，将CMAKE_GDB的路径替换为$HOME/esp-gdb-arm64/bin/xtensa-esp32-elf-gdb

3. 降级到稳定版ESP-IDF #

新版本IDF的GDB工具链可能存在适配漏洞，试试v4.4.x系列：

• 切换分支：git checkout v4.4.5
• 重装工具链：./install.sh esp32
• 重新加载环境后调试

4. 排查硬件连接 #

确保ESP-Prog的JTAG接线正确，先启动openocd验证连接：

• 执行openocd命令后，检查输出是否有Info : JTAG tap: esp32.cpu0 tap/device found: 0x120034e5 (mfg: 0x272 (Tensilica), part: 0x2003, ver: 0x1)这类成功识别芯片的日志
• 如果openocd报错，先解决硬件/接线问题再启动GDB

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