在x86_64平台用Docker交叉编译OpenCV for Raspberry Pi(aarch64)时链接错误求助

问题背景 #

为aarch64架构的树莓派Ubuntu 20.04 LTS交叉编译OpenCV 4.5.1，开发机为x86_64 Ubuntu 20.04 LTS，用Docker管理构建环境，所有依赖（Eigen、Boost、Ceres）均源码编译。CMake配置成功，但make时链接阶段报cv::imread未定义引用；禁用Ceres源码编译则构建成功，但Ceres是必需依赖。

核心原因 #

1. Ceres编译时未使用正确的aarch64交叉编译工具链，生成了x86_64架构的库，导致与目标平台的OpenCV库链接冲突
2. OpenCV的imgcodecs模块（包含cv::imread）因交叉编译环境下图像编解码依赖缺失被自动禁用
3. Ceres编译时误链接了主机/容器内的x86_64版本OpenCV，破坏了后续OpenCV的符号引用

解决方案 #

1. 严格为Ceres配置交叉编译工具链 #

编译Ceres时必须指定树莓派aarch64的CMake工具链文件，确保生成目标架构的库：

cmake -DCMAKE_TOOLCHAIN_FILE=/path/to/rpi_aarch64.cmake \
      -DCMAKE_INSTALL_PREFIX=/your/aarch64/ceres/install \
      -DEIGEN_INCLUDE_DIR=/your/aarch64/eigen/include \
      -DBUILD_EXAMPLES=OFF -DBUILD_TESTING=OFF \
      -DWITH_OPENCV=OFF \  # 禁止Ceres提前链接OpenCV
      /path/to/ceres/source

确保Ceres的所有依赖（如Eigen）均为aarch64源码编译版本，避免引用主机架构库。

2. 强制启用OpenCV的imgcodecs模块 #

cv::imread属于imgcodecs模块，交叉编译时需显式启用并指定aarch64版本的图像编解码依赖：

cmake -DCMAKE_TOOLCHAIN_FILE=/path/to/rpi_aarch64.cmake \
      -DBUILD_opencv_imgcodecs=ON \
      -DWITH_JPEG=ON -DWITH_PNG=ON \
      -DJPEG_INCLUDE_DIR=/your/aarch64/jpeg/include \
      -DJPEG_LIBRARY=/your/aarch64/jpeg/lib/libjpeg.a \
      -DPNG_INCLUDE_DIR=/your/aarch64/png/include \
      -DPNG_LIBRARY=/your/aarch64/png/lib/libpng.a \
      -DCERES_INCLUDE_DIR=/your/aarch64/ceres/include \
      -DCERES_LIBRARY=/your/aarch64/ceres/lib/libceres.a \
      # 其他OpenCV配置参数...
      /path/to/opencv/source

检查CMake配置日志，确认imgcodecs模块状态为ON。

3. 隔离交叉编译环境依赖路径 #

在Docker环境中，通过CMAKE_SYSROOT指定树莓派aarch64根文件系统路径，或在工具链文件中限定依赖搜索范围，避免误引用主机x86_64系统库：
在rpi_aarch64.cmake中添加：

set(CMAKE_SYSROOT /path/to/rpi_aarch64_sysroot)
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)

4. 调整编译顺序 #

先编译所有aarch64版本的基础依赖（Eigen、Boost、图像编解码库），再编译Ceres（禁用OpenCV依赖），最后编译OpenCV并链接已编译好的aarch64版本Ceres。

内容的提问来源于stack exchange，提问作者Jatin Vira Robotics Engineer