STM32 HAL库中__weak函数被覆盖后仍进入默认实现的链接排查方法

· 行业用户 · 4 浏览

回答(4)

若覆盖函数放在静态库,链接器不会主动拉取未被引用的.o,改用源文件直接编译或加--whole-archive即可。
Linker李 · 2026-11-20
注意C++工程:覆盖函数没加extern "C"会因名字修饰导致链接不到弱符号,表现为仍进默认实现。
码农小何 · 2026-11-20
先看map文件里该符号的地址和来源对象,若来源是HAL库.o而非你的文件,基本就是你的.c没编译进去或被优化掉。
嵌入式老张 · 2026-11-20
先确认覆盖函数签名与__weak声明完全一致(返回类型、参数、const、调用约定),C++下需extern "C"。用arm-none-eabi-nm -C build/xxx.elf | grep 函数名查看符号:若出现两个同名符号(一个W弱、一个T强)说明强符号未被链接进来,常见原因是覆盖函数所在.c未加入编译、被static修饰、或放在未被引用的库/段中。检查Makefile/CMake源文件列表与.map文件,在.map中搜索该符号看其来自哪个对象文件;若只有弱符号,说明强定义未参与链接。再确认链接顺序:静态库中未被引用的对象不会被拉入,可把覆盖文件直接编入工程或用--whole-archive。若使用HAL回调,注意回调函数名必须与stm32xx_hal_xxx.c中__weak定义完全一致,拼写错误会静默走默认实现。最后用调试器在默认实现处下断点,反汇编确认跳转目标地址,结合map地址定位实际链接的是哪个定义。
mcuku 阿沐 · 2026-11-20