GitHub Actions中OpenCV C++项目构建报错原因及解决咨询

1. 报错后流程仍执行的原因 #

GitHub Actions的run步骤默认用bash执行多行命令时，不会因某一行命令失败直接终止整个步骤，只要最后一行命令返回成功状态码，步骤就会被标记为成功，后续步骤也会继续运行。

解决方法：在每个run的多行命令开头添加set -e，强制bash遇到错误立即退出：

set -e
# 后续命令...

2. CMake失败的核心原因 #

你的CMake配置中OPENCV_EXTRA_MODULES_PATH路径错误：

-D OPENCV_EXTRA_MODULES_PATH=~/opencv_contrib/modules

GitHub Actions中代码会被checkout到工作目录（如/home/runner/work/git_test2/git_test2），而~指向runner主目录（/home/runner），但你解压的opencv_contrib在当前工作目录下，路径不匹配导致CMake找不到额外模块，引发构建失败。

此外还有几个辅助问题：

• 同时手动编译OpenCV和通过sudo apt install libopencv-dev安装系统预编译版本，两者会冲突干扰构建。
• OpenCV_contrib的解压步骤与下载步骤分离，路径依赖顺序混乱。
• 测试步骤缺少C++代码编译命令，直接运行./a.out必然失败。

3. 修复后的GitHub Actions配置 #

name: C++

on: [push]

jobs:
  build:
    name: Build
    runs-on: ubuntu-latest

    steps:
      - name: Checkout sources
        uses: actions/checkout@v2

      - name: Install dependencies
        run: |
          set -e
          sudo apt-get update
          sudo apt-get install -y libboost-dev cmake g++ wget unzip

      - name: Prepare OpenCV sources
        run: |
          set -e
          wget -O opencv.zip https://github.com/opencv/opencv/archive/3.4.0.zip
          wget -O opencv_contrib.zip https://github.com/opencv/opencv_contrib/archive/3.4.0.zip
          unzip -q opencv.zip && mv opencv-3.4.0 opencv
          unzip -q opencv_contrib.zip && mv opencv_contrib-3.4.0 opencv_contrib

      - name: Build and install OpenCV3.X
        run: |
          set -e
          cd opencv && mkdir -p build && cd build
          cmake -D CMAKE_BUILD_TYPE=RELEASE \
          -D CMAKE_INSTALL_PREFIX=/usr/local \
          -D INSTALL_PYTHON_EXAMPLES=OFF \
          -D INSTALL_C_EXAMPLES=OFF \
          -D OPENCV_ENABLE_NONFREE=ON \
          -D OPENCV_EXTRA_MODULES_PATH=../../opencv_contrib/modules \
          -D BUILD_EXAMPLES=OFF ..
          make -j$(nproc)
          sudo make install
          sudo ldconfig

      - name: Compile and run test code
        run: |
          set -e
          # 替换main.cpp为你的实际源码文件名
          g++ main.cpp -o a.out `pkg-config --cflags --libs opencv`
          echo "===== Testing started ====="
          ./a.out
          echo "===== Testing finished ====="

关键修复点说明 #

• 所有run步骤添加set -e，确保错误立即终止流程。
• 合并OpenCV下载、解压步骤，用相对路径指定OPENCV_EXTRA_MODULES_PATH（适配工作目录结构）。
• 移除系统版OpenCV安装命令，避免版本冲突。
• 添加C++代码编译命令，通过pkg-config自动获取OpenCV编译参数，保证编译正确性。

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