必须用gdbserver是因为嵌入式设备资源受限,gdb本体依赖库多、体积大(超10MB),易因缺少libncurses等库或内存不足而崩溃;gdbserver仅几百KB,可运行于小内存设备,配合主机cross-gdb实现远程调试。

不能直接在嵌入式设备上跑 gdb —— 大多数 ARM/ARM64 板子内存小、无图形界面、甚至没装完整 libc,gdb 本体根本起不来。必须用 gdbserver + 主机 cross-gdb 远程调试。
为什么必须用 gdbserver 而不是本地 gdb
嵌入式 Linux 设备通常资源受限:RAM 小于 256MB、Flash 存储紧张、缺少 libncurses 和 libpython 等依赖,而原生 gdb 是个重型命令行程序,静态链接后仍超 10MB。即使强行编译进去,也极大概率因 mmap 失败或终端初始化失败而退出。
真实场景中,你看到的错误通常是:
error while loading shared libraries: libncurses.so.5: cannot open shared object file-
Cannot access memory at address 0x...(gdb 自身崩溃) -
gdb: command not found(交叉工具链未部署到板子)
所以标准做法是:板子只跑轻量级 gdbserver(通常 gdb 完成。
交叉 GDB 和 gdbserver 版本必须严格匹配架构
拿 ARM32 板子举例:如果你用 aarch64-linux-gnu-gdb 去连 arm-linux-gnueabihf-gdbserver,会卡在 Remote debugging from host xxx 后无响应;反过来,用 arm-linux-gnueabihf-gdb 连错位的 gdbserver,则报 Packet received is too long 或直接拒绝连接。
确认方式很简单:
- 查板子 CPU:
cat /proc/cpuinfo | grep -E "(model name|cpu arch)",看是armv7l还是aarch64 - 查交叉工具链前缀:
arm-linux-gnueabihf-gcc --version或aarch64-linux-gnu-gcc --version -
gdbserver必须和gcc同一工具链编译,不能混用 Buildroot / Yocto / 手动下载的二进制
常见组合:
- ARM32(armv7) →
arm-linux-gnueabihf-gdb+arm-linux-gnueabihf-gdbserver - ARM64(aarch64) →
aarch64-linux-gnu-gdb+aarch64-linux-gnu-gdbserver - 通用 fallback →
gdb-multiarch(但不支持所有 target features,比如硬件单步)
调试时变量显示为 怎么办
这是最常被忽略的坑:即使加了 -g,如果编译时用了 -O2 或更高优化等级,GCC 会把局部变量存进寄存器、内联函数、删掉未使用变量——gdb 查不到它们的内存地址,只能显示 。
解决方法只有两个:
- 重新编译目标程序,明确指定
-O0 -g(不是-Og,某些旧版 GCC 的-Og仍有寄存器优化) - 若必须保留部分优化(如调试驱动模块),改用
-O1 -g,并配合info registers和x/4wx $sp手动扒栈帧找值
验证是否生效:readelf -S ./myapp | grep debug 应有多个 .debug_* 段;再运行 gdb ./myapp -ex "p my_var",不再显示 即可。
coredump 分析必须用同一次编译的带调试信息程序
嵌入式设备生成的 core 文件(如 core.1234)本身不含符号表、不带源码路径、甚至不含动态库基址偏移。它只是崩溃瞬间的内存快照。
你必须把当时编译出的、带 -g 的那个 ./myapp 二进制(不是现在随便 recompile 一个)和 core.1234 一起拷到主机,用对应交叉 gdb 加载:
arm-linux-gnueabihf-gdb ./myapp ./core.1234
否则 bt 只能打出裸地址(如 #0 0x00012345 in ?? ()),list 直接报错 No symbol table is loaded。
关键细节:
- 不要用
strip ./myapp—— 会删掉.debug_*段,gdb彻底失明 - 不要用
objcopy --only-keep-debug单独抽 debug info ——gdb加载 core 时需要主程序中保留的.symtab和.strtab - 建议在 Makefile 里加一句:
cp $@ $@.debug,每次编译自动备份可调试版本











