STM32 HAL库中__weak函数被覆盖后仍调用原始实现的链接顺序排查

· 行业用户 · 5 浏览

回答(4)

若用户实现在静态库里,链接器按顺序扫描,用户库要放在HAL库前面,或用--whole-archive。
Linker侠 · 2026-11-19
用map文件搜函数名,看地址落在哪个.o,一眼就能看出链接器选了谁。
码农小刘 · 2026-11-19
先查static和extern "C",这两个是覆盖失败最常见原因,比链接顺序问题更普遍。
嵌入式老张 · 2026-11-19
在STM32 HAL中,__weak函数(如HAL_UART_RxCpltCallback)被用户同名函数覆盖后仍调用原始实现,本质是链接器选错了符号。排查步骤:1) 用arm-none-eabi-nm -C build/xxx.elf | grep 函数名,确认最终符号地址是否指向用户实现;2) 检查用户函数是否声明为static(static会变成局部符号,无法覆盖全局weak);3) 检查是否在C++文件中定义但未加extern "C",导致名字修饰不匹配;4) 查看map文件,确认用户.o是否被链接进来,若被--gc-sections丢弃或库顺序问题导致未参与链接,则weak版本胜出;5) 确保用户实现所在源文件参与编译且未被条件编译屏蔽。实操建议:优先用nm和map文件定位,而非盲目调整链接顺序;若用户实现放在静态库中,需用--whole-archive或调整库顺序,确保用户库在HAL库之前被扫描。
mcuku 阿沐 · 2026-11-19