Apollo 9.0在NVIDIA Orin平台上的构建问题分析与解决方案

问题背景

在NVIDIA DRIVE Orin平台上构建Apollo 9.0自动驾驶系统时，开发者可能会遇到一系列构建失败的问题。这些问题主要涉及动态链接库缺失和符号引用未定义等编译链接阶段的错误。本文将详细分析这些问题的根源，并提供完整的解决方案。

主要问题分析

1. 动态链接库缺失问题

在构建过程中，系统首先报错提示无法找到libnvinfer.so.8等CUDA相关库文件。这是由于Docker容器内部缺少主机系统中的关键库文件所致。

根本原因：Docker容器默认情况下无法访问主机系统的/usr/lib目录，而Apollo的某些组件需要依赖这些预装的库文件。

2. ADOL-C库链接问题

在解决第一个问题后，构建过程中又出现了关于adouble和adub等符号未定义的链接错误。这些符号属于ADOL-C(自动微分库)的功能。

根本原因：ADOL-C库在安装时没有启用稀疏矩阵支持(--enable-sparse选项)，而Apollo的规划模块恰好需要这些功能。

详细解决方案

动态链接库问题的解决

1. 临时解决方案：可以通过docker cp命令将主机/usr/lib目录下的相关.so文件复制到Docker容器中。

2. 永久解决方案：修改docker/scripts/dev_start.sh启动脚本，在docker run命令中添加-v /usr/lib:/usr/lib参数，将主机的/usr/lib目录挂载到容器中。

# 修改后的docker run命令示例
docker run -v /usr/lib:/usr/lib [其他参数] ...

这种方法确保了容器在运行时能够直接访问主机的库文件，避免了手动复制的不便。

ADOL-C库问题的解决

1. 重新安装ADOL-C：

   • 首先需要卸载现有的ADOL-C安装
   • 然后使用正确的配置选项重新编译安装

2. 正确的安装步骤：

./configure --prefix=/usr/local --enable-sparse
make
sudo make install

关键点在于必须添加--enable-sparse配置选项，这会启用稀疏矩阵相关功能的编译，而这些功能正是Apollo规划模块所需要的。

问题排查技巧

1. 错误信息分析：当遇到链接错误时，首先注意错误信息中提到的缺失符号，这些符号通常能直接指向问题的根源。

2. 库文件检查：

   • 使用ldd命令检查可执行文件的依赖关系
   • 使用nm命令检查库文件是否包含特定符号

3. 环境变量验证：确认LD_LIBRARY_PATH是否包含所有必要的库路径。

最佳实践建议

1. 构建环境准备：

   • 在主机系统上预先安装所有必需的依赖库
   • 确保这些库的版本与Apollo要求一致

2. Docker配置：

   • 合理规划Docker卷挂载策略
   • 考虑将主机的主要库目录挂载到容器中

3. 特殊库处理：

   • 对于像ADOL-C这样的特殊库，仔细阅读其文档
   • 确保启用项目所需的所有功能选项

总结

在NVIDIA Orin平台上构建Apollo 9.0时遇到的这些问题，反映了交叉编译环境下常见的依赖管理挑战。通过系统性地分析错误信息，理解Apollo各模块的依赖关系，并采取适当的配置措施，开发者可以成功完成构建。本文提供的解决方案不仅适用于所述的具体问题，其思路和方法也可应用于其他类似的构建问题排查中。

对于自动驾驶系统的开发者而言，深入理解这些构建问题的解决方法，有助于提高开发效率，并为后续可能遇到的其他平台适配问题提供参考。