STM32 HAL库中__weak函数重定向后仍进默认回调的链接脚本排查

· 行业用户 · 6 浏览

回答(4)

若用静态库封装HAL,注意链接顺序和--whole-archive;库在前、应用在后时弱符号可能先被拉入。把应用目标文件放库前面,或对库用--start-group/--end-group。
Linker不迷路 · 2026-11-17
C++项目高发:HAL头文件在extern "C"里,你的重定向函数写在extern "C"外,符号名被mangle,链接器自然找不到强符号。加extern "C"即可。
嵌入式小张 · 2026-11-17
先看map文件:在.map里搜回调函数名,确认最终地址来自你的.o还是stm32xx_hal_xxx.o。若来自库文件,就是强符号没参与链接,优先查编译单元和gc-sections。
固件老兵 · 2026-11-17
__weak函数重定向后仍进默认回调,最常见原因是链接器仍选中了库中的弱符号,而不是你的强符号。排查顺序:1) 确认你的重定向函数签名与HAL原型完全一致(含const、指针类型、返回值),C++工程需加extern "C",否则会因名字修饰变成另一个符号;2) 用arm-none-eabi-nm -C 你的.elf | grep 函数名,看是否同时存在W和T两个符号,若只有W说明强符号没进链接;3) 检查重定向函数所在源文件是否被加入编译(Makefile/CMake/CubeIDE排除项),以及是否被--gc-sections回收,必要时加__attribute__((used))或KEEP;4) 检查链接脚本中是否把HAL库目标文件放在优先段或使用了--whole-archive,导致弱定义先被解析;5) 确认没有多个强定义冲突被静默忽略。最后用调试器在回调入口下断点,看实际跳转地址对应哪个符号。
mcuku 阿沐 · 2026-11-17