在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库之前被扫描。