CMake编译带CUDA的OpenCV出现多类错误，求解决方案

问题概述 #

编译OpenCV 4.7.0（含opencv-contrib）并启用CUDA支持时，出现opencl_kernels_*.hpp文件缺失、链接错误及多个模块构建失败的问题，核心错误示例如下：

自定义构建警告 #

D:\Program Files\Microsoft Visual Studio\2022\Enterprise\MSBuild\Microsoft\VC\v170\Microsoft.CppCommon.targets(248,5): warning MSB8065: Custom build for item E:\OpenCV\builds\CMakeFiles\73fe723e92479b05f06abfab27cdceae\opencl_kernels_core.cpp.rule succeeded, but specified output e:\opencv\builds\modules\core\opencl_kernels_core.cpp has not been created. This may cause incremental build to work incorrectly.

编译错误 #

C:\OpenCV\sources\opencv-4.7.0\modules\core\src\arithm.cpp(51,10): fatal error C1083: Cannot open include file: ‘opencl_kernels_core.hpp’: No such file or directory

链接错误 #

Done building project opencv_core.vcxproj – FAILED.
LINK : fatal error LNK1181: cannot open input file ‘…..\lib\Release\opencv_core470.lib’

批量模块构建失败 #

Done building project opencv_hfs.vcxproj – FAILED.
Done building project opencv_img_hash.vcxproj – FAILED.
Done building project opencv_plot.vcxproj – FAILED.
Done building project opencv_quality.vcxproj – FAILED.
Done building project opencv_cudafilters.vcxproj – FAILED.

环境信息 #

• 操作系统：Windows 11
• 硬件：RTX 2060 Super
• 依赖版本：CUDA 12.2、CUDNN、Python 3.11、Visual Studio 2022（含C++桌面开发组件）、CMake 3.26.4、OpenCV 4.7.0 + opencv-contrib 4.7.0源码

解决步骤 #

1. 清理缓存并重新配置CMake #

• 删除OpenCV构建目录下的所有文件（包括CMakeCache.txt和CMakeFiles文件夹），避免旧配置干扰
• 重新打开CMake，指定OpenCV源码路径和无空格、无中文的新构建路径
• 配置时调整以下关键选项：
  • 勾选BUILD_opencv_world：合并所有模块为单个库，减少跨模块链接问题
  • 确认WITH_CUDA、WITH_CUDNN已勾选，且CMake正确识别CUDA路径
  • 取消勾选BUILD_opencv_hfs：该模块兼容性较差，非必需时禁用可避免构建失败
  • 若无需OpenCL支持，取消勾选WITH_OPENCL：避免OpenCL内核生成逻辑冲突
  • 设置CMAKE_INSTALL_PREFIX为非系统目录（如E:\OpenCV\install），避免权限限制

2. 修复OpenCL内核生成问题（如需保留OpenCL） #

• 确保构建路径无特殊字符（空格、中文等），否则自定义构建规则无法生成输出文件
• 在CMake中设置OPENCV_DUMP_OPENCL_KERNELS=ON，强制生成OpenCL内核头文件
• 配置完成后，先单独构建OpenCL内核模块：

  cmake --build . --target opencl_kernels
  

  待内核模块构建完成后，再执行全项目构建

3. 调整Visual Studio构建配置 #

• 打开生成的OpenCV.sln，将解决方案配置设为Release（Debug构建易出现链接错误）
• 右键解决方案 → 生成依赖项 → 项目依赖项，确保opencv_core在所有依赖它的模块之前构建
• 检查每个失败项目的「VC++目录 → 包含目录」，确认构建目录下的modules/core/include已被添加

4. 验证CUDA版本兼容性 #

• OpenCV 4.7.0官方对CUDA 12.2的支持不完善，建议降级到CUDA 11.7（官方推荐版本）
• 若坚持使用CUDA 12.2，需确保CUDNN版本与CUDA版本严格匹配

5. 权限问题排查 #

• 以管理员身份运行CMake和Visual Studio，避免因权限不足导致文件无法生成或写入
• 确认构建目录和安装目录具备读写权限

内容的提问来源于stack exchange，提问作者Eduardo Maciel Sanchez