RTAB-Map项目在多架构Docker容器中的编译问题与解决方案

问题背景

RTAB-Map是一个开源的实时外观定位与建图（SLAM）系统，广泛应用于机器人导航和3D重建领域。在实际部署过程中，开发者经常需要在不同的硬件架构（如amd64和arm64）上构建Docker容器。本文记录了在amd64架构上构建RTAB-Map时遇到的一个特定编译问题及其解决方案。

核心问题描述

在amd64架构的Docker容器中，当尝试通过CMake构建RTAB-Map并启用PyTorch支持时（使用-DTorch_DIR标志），系统无法找到多个位于/usr/lib/x86_64-linux-gnu目录下的关键库文件，如PCL_COMMON、PCL_OCTREE等。这导致编译失败，出现大量未定义引用错误。

值得注意的是，相同的配置在arm64架构上能够正常工作，这表明问题具有架构相关性。

问题分析

经过深入调查，发现以下几个关键因素：

1. 基础镜像差异：amd64环境使用的是nvidia/cuda:12.1.0-devel-ubuntu22.04基础镜像，而arm64环境使用了不同的配置。

2. CMake版本差异：amd64环境使用CMake 3.22.1，而arm64使用3.29.1，虽然版本差异不大，但可能影响库搜索行为。

3. OpenCV冲突：系统同时存在NVIDIA构建的OpenCV和系统OpenCV，前者缺少stitching模块，导致兼容性问题。

4. 环境变量问题：虽然LD_LIBRARY_PATH未改变，但CMake的库搜索路径在设置Torch_DIR后出现了变化。

解决方案

1. 使用正确的PyTorch基础镜像

推荐使用NVIDIA官方提供的PyTorch镜像作为基础，该镜像同时支持amd64和arm64架构，并基于Ubuntu 22.04（Jammy），兼容ROS2 Humble。

2. 显式指定库路径

在CMake配置中，需要显式指定关键库的路径：

cmake -DTorch_DIR=/usr/local/lib/python3.10/dist-packages/torch/share/cmake/Torch \
      -DOpenCV_DIR=/usr/lib/x86_64-linux-gnu/cmake/opencv4 \
      -DWITH_TORCH=ON \
      -DWITH_PYTHON=ON ..

3. 处理OpenCV依赖关系

需要注意安装libopencv-dev的顺序，因为它可能影响Python中cv2模块的功能。建议：

1. 先完成所有需要原始OpenCV的操作（如生成superpoint.pt文件）
2. 再安装libopencv-dev
3. 最后构建RTAB-Map

4. ROS2构建注意事项

构建rtabmap_ros时同样需要指定OpenCV路径：

colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release -DOpenCV_DIR=/usr/lib/x86_64-linux-gnu/cmake/opencv4

5. 运行时环境变量

运行时可能需要设置额外的库路径：

export LD_LIBRARY_PATH=/opt/hpcx/ucx/lib:$LD_LIBRARY_PATH

6. SuperGlue配置

使用SuperGlue时需要额外配置参数：

"PyMatcher/Path": "/PATH/TO/SuperGluePretrainedNetwork/rtabmap_superglue.py"

技术要点总结

1. 多架构兼容性：不同CPU架构下的构建环境可能存在细微差异，需要特别注意库路径和依赖关系。

2. 显式路径指定：在复杂的依赖环境中，显式指定关键库的CMake配置路径可以避免自动搜索带来的问题。

3. 构建顺序管理：某些库的安装顺序可能影响其他组件的功能，需要合理安排构建流程。

4. 运行时环境：构建成功不代表运行时没有问题，需要注意环境变量的正确设置。

通过以上解决方案，开发者可以在amd64架构上成功构建支持PyTorch和CUDA的RTAB-Map，为机器人视觉SLAM应用提供强大的支持。