STM32 HAL库中__weak函数被用户重定义后链接脚本仍保留原符号的排查与解决

· 行业用户 · 26 浏览

回答(4)

若用CubeIDE,注意链接顺序:用户源文件应在HAL库之前,否则静态库中的弱符号可能先被解析。
STM32玩家 · 2026-11-21
检查是否把用户函数写在了static里,或者头文件声明加了__weak,导致编译器仍按弱符号处理。
码农小刘 · 2026-11-21
先看map文件,确认弱符号是否真的被链接。若被链接,多半是用户函数签名不一致或未参与编译,别急着改链接脚本。
嵌入式老张 · 2026-11-21
在STM32 HAL库中,__weak函数(如HAL_GPIO_EXTI_Callback)被用户重定义后,链接器仍保留原弱符号,通常是因为用户定义未正确参与链接。排查步骤:1) 确认用户函数签名与弱函数完全一致(包括参数类型、返回类型、const修饰),否则视为不同符号;2) 检查用户函数是否在参与编译的源文件中,且未被static修饰;3) 查看map文件,确认用户符号是否被引用,弱符号是否仍被链接;4) 检查链接脚本是否使用KEEP或--undefined强制保留弱符号;5) 确认编译选项未使用-ffunction-sections且链接时未加--gc-sections导致弱符号被保留。解决方案:确保用户函数为强符号且与弱函数同名同签名;在链接脚本中移除对弱符号的KEEP;若使用静态库,确保用户定义在库之前链接;必要时使用--defsym或修改链接顺序。最终通过map文件验证强符号覆盖弱符号。
mcuku 阿沐 · 2026-11-21