无法为AIX交叉编译包含boost/asio/ssl.hpp的简单代码

问题场景 #

交叉编译包含<boost/asio/ssl.hpp>的简单程序时，链接器返回大量未定义引用错误（涉及AES_encrypt、gcm_init_p8等函数），同时出现OpenSSL 3.0废弃API警告。

程序代码：

#include <boost/asio/ssl.hpp>

int main()
{
    return 0;
}

编译命令：

/opt/crossaix/bin/powerpc-ibm-aix7.1.0.0-g++ -L/tmp/vcpkg/lib/ -I/tmp/vcpkg/include/ -std=c++11 main.cpp -o custmain -lpthread -lcrypto -latomic

环境说明：

• /tmp/vcpkg/lib存放vcpkg获取的OpenSSL libcrypto.a等库文件
• /tmp/vcpkg/include存放Boost.Asio及OpenSSL头文件
• 已通过AIX机器上的nm命令确认libcrypto.a中存在AES_encrypt符号，添加-lssl后问题仍未解决

排查步骤 #

1. 调整库的链接顺序

AIX链接器对库的依赖顺序敏感，依赖关系靠后的库需要先指定。Boost.Asio SSL依赖OpenSSL的libssl和libcrypto，且libssl依赖libcrypto，同时Boost.Asio本身依赖libboost_system，需将库放在源文件之后：

/opt/crossaix/bin/powerpc-ibm-aix7.1.0.0-g++ -L/tmp/vcpkg/lib/ -I/tmp/vcpkg/include/ -std=c++11 main.cpp -o custmain -lpthread -latomic -lboost_system -lssl -lcrypto

2. 验证库的平台兼容性

确保vcpkg获取的OpenSSL和Boost库是针对powerpc-ibm-aix7.1.0.0交叉编译的，而非x86平台库。用交叉工具链的nm直接在编译主机检查符号格式：

/opt/crossaix/bin/powerpc-ibm-aix7.1.0.0-nm /tmp/vcpkg/lib/libcrypto.a | grep AES_encrypt

查看输出符号类型（T表示已定义函数），确认是PowerPC架构符号。

3. 解决OpenSSL 3.0 API兼容性

OpenSSL 3.0废弃了大量旧API，Boost.Asio可能仍在使用这些接口，可通过两种方式处理：

• 添加兼容宏定义，强制OpenSSL启用旧API支持：

  /opt/crossaix/bin/powerpc-ibm-aix7.1.0.0-g++ -L/tmp/vcpkg/lib/ -I/tmp/vcpkg/include/ -std=c++11 -DOPENSSL_API_COMPAT=0x10100000L main.cpp -o custmain -lpthread -latomic -lboost_system -lssl -lcrypto
  

• 改用OpenSSL 1.1.x版本：通过vcpkg安装OpenSSL 1.1.x，其API与Boost.Asio兼容性更好。

4. 确认Boost.Asio的SSL支持状态

检查vcpkg安装Boost时是否启用了SSL支持，若默认编译未开启，需重新安装并指定SSL相关编译选项（如--feature-flags=asio-ssl，具体参考vcpkg的Boost端口配置）。

5. 直接指定库文件路径

若链接器未正确识别库路径，直接指定libssl.a和libcrypto.a的完整路径：

/opt/crossaix/bin/powerpc-ibm-aix7.1.0.0-g++ -L/tmp/vcpkg/lib/ -I/tmp/vcpkg/include/ -std=c++11 main.cpp -o custmain -lpthread -latomic -lboost_system /tmp/vcpkg/lib/libssl.a /tmp/vcpkg/lib/libcrypto.a

6. 查看详细链接日志

添加AIX链接器选项-bnoquiet，获取详细链接过程，确认链接器是否在目标库中查找符号，以及是否存在符号名差异：

/opt/crossaix/bin/powerpc-ibm-aix7.1.0.0-g++ -L/tmp/vcpkg/lib/ -I/tmp/vcpkg/include/ -std=c++11 main.cpp -o custmain -lpthread -latomic -lboost_system -lssl -lcrypto -bnoquiet

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