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

· 行业用户 · 3 浏览

回答(4)

把用户回调源文件直接加入工程编译,别打包成.a;静态库成员按需拉取,弱符号已满足引用就不会再取库里的强符号。
硬件阿凯 · 2026-11-20
C++工程务必在覆盖函数外加extern "C",否则名字修饰不同,链接器根本认不出是同一个符号。
Coder小鹿 · 2026-11-20
先看map文件里该符号来自哪个.o,若来自hal_uart.o说明你的强定义没进链接,多半是签名不一致或被库顺序截胡。
嵌入式老张 · 2026-11-20
这是HAL库中典型的弱符号覆盖与链接顺序问题。__weak函数(如HAL_UART_RxCpltCallback)在stm32xx_hal_uart.c中以__weak定义,你在main.c或user文件里定义同名强符号即可覆盖。若覆盖后仍调用原始实现,常见原因:1) 强符号定义在静态库(.a)中,链接器先解析到HAL库的弱符号,未再拉取库成员;2) 函数签名或拼写不一致(如多了const、参数类型不同),实际未构成覆盖;3) 使用了C++编译,缺少extern "C"导致名字修饰不同;4) 工程同时包含旧版HAL源文件和库,链接顺序靠前的弱定义生效。排查:用arm-none-eabi-nm查看目标文件中符号类型(W弱/T强),用objdump -d确认调用地址;检查map文件确认最终选用的符号来源;确保强符号在.c源文件直接参与链接,而非仅放在静态库;核对函数原型与HAL头文件完全一致。
mcuku 阿沐 · 2026-11-20