ROS2 Debian包生成问题：bloom无法识别源码安装的OpenCV 4.7.0

问题根源 #

本地用colcon build时，CMake能直接找到你源码安装在/usr/local的OpenCV 4.7.0，但Bloom生成Debian包是严格遵循Debian的依赖规则——它会优先解析package.xml里的依赖声明，Ubuntu 22.04官方源的libopencv-dev是4.5.4版本，自然会拉取这个版本。另外CI/CD容器里要么没预安装源码版OpenCV，要么构建Debian包时的CMake配置被重置，导致无法定位到正确版本。

解决办法 #

1. 调整package.xml的依赖声明 #

不要直接声明依赖libopencv-dev，改为添加版本约束，明确要求更高版本：

<!-- 针对Ubuntu 22.04/humble指定版本要求 -->
<build_depend>libopencv-dev (&gt;= 4.7.0)</build_depend>
<exec_depend>libopencv-dev (&gt;= 4.7.0)</exec_depend>

注意：如果官方源没有4.7.0版本的libopencv-dev，这个约束会导致依赖无法满足，需要配合后续步骤解决。

2. 在CI/CD容器中预编译安装OpenCV 4.7.0 #

在Dockerfile或CI流水线脚本中，提前完成OpenCV 4.7.0的源码编译安装，确保Debian包构建环境中存在该版本：

# 安装编译依赖
apt-get update && apt-get install -y build-essential cmake git libgtk2.0-dev pkg-config libavcodec-dev libavformat-dev libswscale-dev
# 拉取OpenCV 4.7.0源码
git clone --branch 4.7.0 https://github.com/opencv/opencv.git
cd opencv && mkdir build && cd build
# 编译安装到/usr/local（源码安装默认路径）
cmake -D CMAKE_BUILD_TYPE=Release -D CMAKE_INSTALL_PREFIX=/usr/local ..
make -j$(nproc)
make install
# 更新系统库缓存
ldconfig

3. 修改CMakeLists.txt强制指定查找路径 #

在find_package(OpenCV ...)代码前添加路径指定，确保Debian构建时优先查找源码安装的版本：

# 指定OpenCV的CMake配置文件路径
set(OpenCV_DIR /usr/local/lib/cmake/opencv4)
find_package(OpenCV 4.7.0 REQUIRED COMPONENTS core imgproc highgui)

4. 调整Bloom生成的Debian规则文件 #

用bloom-generate生成debian模板后，手动修改相关配置：

• 如果你自己打包了OpenCV 4.7.0的Debian包，将debian/control中的依赖改为libopencv4-dev (>=4.7.0)
• 若未自行打包，在debian/rules中添加CMake参数，明确指定OpenCV路径：

  override_dh_auto_configure:
      dh_auto_configure -- -DOpenCV_DIR=/usr/local/lib/cmake/opencv4
  

5. 检查CI/CD环境的环境变量 #

确保CI容器中没有覆盖关键环境变量，在CI脚本中添加：

export CMAKE_PREFIX_PATH=/usr/local:$CMAKE_PREFIX_PATH
export OpenCV_DIR=/usr/local/lib/cmake/opencv4

验证步骤 #

• 在CI容器中执行pkg-config --modversion opencv4，确认输出为4.7.0
• 手动执行colcon build，确保项目构建正常
• 再次运行bloom-generate rosdebian --os ubuntu --ros-distro humble，检查生成的debian/control文件中依赖是否正确

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