STM32 CubeIDE链接失败：未定义引用HAL_RTC相关函数

错误信息 #

ld: home/.../foobar.o: in function foobar_myFunc': /home/.../foobar.c: undefined reference to HAL_RTCEx_BKUPWrite'
ld: /home/.../foobar.o: in function rtcHal_getUnixTime': /home/.../foobar.c:902: undefined reference to HAL_RTC_GetTime'
ld: /home/.../foobar.c:921: undefined reference to HAL_RTC_GetDate' ld: /home/.../foobar.c:929: undefined reference to HAL_RTC_GetTime'
collect2: error: ld returned 1 exit status

解决步骤 #

• 检查RTC HAL库文件是否纳入工程
  确认stm32fxxx_hal_rtc.c和stm32fxxx_hal_rtc_ex.c（xxx替换为你的芯片系列，如f1/f4/f7）存在于工程目录中（通常在Drivers/STM32Fxx_HAL_Driver/Src或Core/Src）。如果缺失，重新通过CubeMX配置RTC外设，自动生成这些文件。
  若文件存在，右键工程→Properties→C/C++ Build→Settings→MCU GCC Compiler→Includes，确保头文件路径（如Drivers/STM32Fxx_HAL_Driver/Inc）已添加；再到MCU GCC Linker→Libraries确认HAL库链接配置正确，或直接查看工程Makefile，确认上述.c文件在源文件列表内。

• 验证HAL库配置宏
  打开stm32fxx_hal_conf.h，确保HAL_RTC_MODULE_ENABLED和HAL_RTC_EX_MODULE_ENABLED未被注释。若未定义，可手动添加，或通过CubeMX的Project Manager→Advanced Settings勾选RTC及RTCEx模块。

• 确认头文件引用
  在调用RTC函数的foobar.c顶部，添加必要的头文件：

  #include "stm32fxx_hal_rtc.h"
  #include "stm32fxx_hal_rtc_ex.h"
  

  注意替换xx为对应芯片系列。

• 清理缓存重新编译
  点击CubeIDE工具栏Project→Clean...，选择当前工程执行清理，之后重新Build整个工程。

内容的提问来源于stack exchange，提问作者beyarkay