Ubuntu 22.04编译OpenCV 4.6后出现第三方库未定义引用错误

一、检查OpenCV编译时的依赖链接状态 #

• 找到OpenCV编译后的OpenCVConfig.cmake文件（通常在/usr/local/lib/cmake/opencv4/或自定义安装路径下），查看其中的OpenCV_LIBS变量，确认是否包含avcodec、avformat、protobuf等FFmpeg和Protobuf相关库。如果缺失，说明编译OpenCV时未正确链接这些依赖，需重新编译：
  1. 重新运行CMake，确保启用WITH_FFMPEG=ON、WITH_PROTOBUF=ON，同时检查FFMPEG_INCLUDE_DIRS、FFMPEG_LIBRARIES、Protobuf_INCLUDE_DIR、Protobuf_LIBRARIES是否指向系统正确的库路径。
  2. 编译时添加VERBOSE=1参数（make VERBOSE=1），查看编译过程是否实际链接了这些第三方库，避免系统库版本冲突导致的隐性链接失败。

二、检查自身CPP程序的CMake配置 #

• 确保CMakeLists.txt正确引入OpenCV并链接必要库：

  find_package(OpenCV REQUIRED)
  include_directories(${OpenCV_INCLUDE_DIRS})
  add_executable(your_program your_code.cpp)
  target_link_libraries(your_program ${OpenCV_LIBS})
  

• 若OpenCV为自定义路径安装，需在CMake开头指定CMAKE_PREFIX_PATH指向安装目录：

  set(CMAKE_PREFIX_PATH "/your/custom/opencv/install/path")
  

• 若OpenCV配置未自动传递依赖，可尝试显式链接第三方库：

  find_package(FFmpeg REQUIRED)
  find_package(Protobuf REQUIRED)
  target_link_libraries(your_program ${FFMPEG_LIBRARIES} ${Protobuf_LIBRARIES})
  

三、检查系统库版本冲突 #

• 执行以下命令查看系统已安装的库版本，确认是否与编译OpenCV时使用的版本一致：

  dpkg -l | grep ffmpeg
  dpkg -l | grep protobuf
  

• 若编译OpenCV时用了源码安装的第三方库而非系统库，需确保自身程序编译时优先查找这些库，可通过设置路径变量指定：

  set(CMAKE_INCLUDE_PATH "/path/to/custom/ffmpeg/include;/path/to/custom/protobuf/include")
  set(CMAKE_LIBRARY_PATH "/path/to/custom/ffmpeg/lib;/path/to/custom/protobuf/lib")
  

四、验证OpenCV功能完整性 #

• 运行OpenCV自带的video_capture示例程序，若示例也出现相同错误，说明OpenCV编译不完整，需重新编译并确保所有依赖正确链接：

  cd opencv-4.6.0/samples/cpp
  mkdir build && cd build
  cmake .. && make
  ./video_capture
  

• 若示例正常运行，说明问题出在自身程序的CMake配置，需再次检查链接规则。

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