GitLab Docker中ROS2包生成.deb时无法找到OpenCV4.6.0与cv_bridge

核心原因分析 #

本地环境中你已经source了OpenCV和cv_bridge的构建空间，CMake能通过CMAKE_PREFIX_PATH自动找到配置文件，但GitLab Docker流水线的bloom-generate rosdebian过程是在干净的构建环境中执行的，不会继承你手动source的环境变量，也不会自动识别源码构建的依赖包路径。

具体解决方案 #

1. 在Docker镜像中预安装源码构建的OpenCV和cv_bridge #

不要在流水线临时构建依赖，而是把OpenCV 4.6.0和cv_bridge的源码构建过程集成到自定义Docker镜像中：

• 编写Dockerfile，基于对应版本的ROS2基础镜像（如humble/foxy）：

  # 安装OpenCV 4.6.0编译依赖
  RUN apt-get update && apt-get install -y \
      build-essential cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev \
      python3-dev python3-numpy libtbb2 libtbb-dev libjpeg-dev libpng-dev libtiff-dev libdc1394-22-dev
  
  # 源码编译安装OpenCV 4.6.0
  RUN git clone --branch 4.6.0 https://github.com/opencv/opencv.git /tmp/opencv && \
      mkdir -p /tmp/opencv/build && cd /tmp/opencv/build && \
      cmake -D CMAKE_INSTALL_PREFIX=/usr/local/opencv460 .. && \
      make -j$(nproc) && make install
  
  # 配置OpenCV环境变量，让CMake能自动找到配置文件
  ENV OpenCV_DIR=/usr/local/opencv460/lib/cmake/opencv4
  ENV CMAKE_PREFIX_PATH="/usr/local/opencv460:${CMAKE_PREFIX_PATH}"
  
  # 源码编译安装对应ROS2版本的cv_bridge
  RUN mkdir -p /tmp/cv_ws/src && cd /tmp/cv_ws/src && \
      git clone https://github.com/ros-perception/vision_opencv.git && \
      cd vision_opencv && git checkout <你的ROS2版本分支> && \
      cd ../.. && colcon build --packages-select cv_bridge --cmake-args -DOpenCV_DIR=/usr/local/opencv460/lib/cmake/opencv4
  
  # 持久化cv_bridge的环境变量配置
  RUN echo "source /tmp/cv_ws/install/setup.bash" >> /root/.bashrc
  

• 构建并推送这个自定义镜像到GitLab容器Registry，流水线中直接使用该镜像替代默认ROS2镜像。

2. 在CI脚本中显式注入依赖路径 #

如果不想自定义镜像，可在GitLab CI的打包步骤前，手动设置环境变量并确保依赖路径被正确添加：

# 假设OpenCV和cv_bridge已在流水线指定路径完成构建
export OpenCV_DIR=/path/to/opencv/build/lib/cmake/opencv4
export CMAKE_PREFIX_PATH="/path/to/cv_bridge/install:${OpenCV_DIR}/../..:${CMAKE_PREFIX_PATH}"

# 提前source依赖的环境配置文件
source /path/to/opencv/build/setup.bash || true
source /path/to/cv_bridge/install/setup.bash

# 执行bloom生成debian配置
bloom-generate rosdebian --os ubuntu --dist jammy --ros-distro humble

注意：确保流水线中构建依赖与打包步骤的工作目录一致，或使用绝对路径，避免路径丢失。

3. 调整CMakeLists.txt的查找逻辑 #

在你的ROS2包的CMakeLists.txt中，显式支持从环境变量读取依赖路径：

# 优先从环境变量获取OpenCV路径
if(DEFINED ENV{OpenCV_DIR})
  set(OpenCV_DIR $ENV{OpenCV_DIR})
endif()

find_package(OpenCV 4.6.0 REQUIRED)

# 同理处理cv_bridge
if(DEFINED ENV{cv_bridge_DIR})
  set(cv_bridge_DIR $ENV{cv_bridge_DIR})
endif()

find_package(cv_bridge REQUIRED)

这样CMake能直接读取环境变量中的路径，无需依赖自动路径查找。

4. 修改bloom生成的debian配置 #

bloom-generate生成的debian/rules文件可能会重置环境变量，可在生成后手动注入配置：

# 在bloom-generate执行后，修改debian/rules文件
sed -i '/export DEB_BUILD_MAINT_OPTIONS/a export OpenCV_DIR=/path/to/opencv/build/lib/cmake/opencv4' debian/rules
sed -i '/export DEB_BUILD_MAINT_OPTIONS/a export CMAKE_PREFIX_PATH="/path/to/cv_bridge/install:${CMAKE_PREFIX_PATH}"' debian/rules

之后再执行dpkg-buildpackage完成打包。

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