嵌入式开发中Static Library+GCC环境下weak functions未定义引用问题

嘿，我之前在做嵌入式单元测试时也碰到过一模一样的问题，咱们一步步来搞定它！

先理清楚问题根源 #

你提到这个静态库在正常项目里能正常链接，但单元测试时报错，核心原因大概率是单元测试的链接配置和正常项目不一致，或者链接器在单元测试环境下对weak符号的处理逻辑有变化——毕竟单元测试通常不会依赖完整的硬件环境，有些weak函数可能因为“看起来没被使用”被链接器优化掉了，或者项目没正确关联到库的weak符号。

具体解决方案 #

这里给你几个实用的排查和解决步骤：

• 第一步：确认单元测试项目的链接配置是否正确
  先去Atollic TrueStudio的项目属性里，找到C/C++ Build > Settings > Tool Settings > ARM GCC Linker > Libraries：

  • 检查你的静态库（.a文件）是不是已经添加到Libraries (-l)列表里；
  • 库文件所在的路径有没有加到Library search path (-L)中；
  • 另外，别漏了检查链接器的其他参数，确保没有加--no-weak这种会忽略weak符号的flags，ARM GCC默认是支持weak符号的，不要手动禁用它。

• 第二步：为缺失的Weak函数提供单元测试专属的默认实现
  很多HAL的weak函数是用来让用户重写硬件初始化逻辑的，比如HAL_UART_MspInit这类。单元测试环境下没有真实硬件，你可以自己写一个空的或者模拟的实现，来补全链接时的符号缺失：

  // 在单元测试的源文件里添加这个实现
  void HAL_UART_MspInit(UART_HandleTypeDef *huart) __attribute__((weak));
  void HAL_UART_MspInit(UART_HandleTypeDef *huart) {
      // 空实现或者根据测试需求写模拟逻辑
  }
  

  这样链接器会优先使用你提供的这个版本，就不会报Undefined Reference了。

• 第三步：用链接器参数强制包含库中所有符号
  有时候链接器会做优化，把它认为“未被使用”的weak符号删掉，这时候可以用--whole-archive参数强制它包含静态库的所有符号。在Atollic的链接器Miscellaneous选项里添加：

  --whole-archive -lyour_static_library_name --no-whole-archive
  

  注意要把--no-whole-archive放在后面，不然会影响其他库的链接优化哦。

• 第四步：如果混用C++，检查编译选项
  要是你的项目里有C++代码，记得检查编译flags里有没有-fweak-template-vtables——ARM GCC默认是开启这个选项的，它会影响模板类的weak符号处理，如果手动关闭了，可能导致weak符号异常。

总结 #

先从链接配置查起，这是最常见的问题；如果还是不行，就给缺失的weak函数写个简单实现；最后再用链接器参数强制包含符号，基本上就能解决这个Undefined Reference的问题啦。

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