同目录下OpenCV部分共享库加载失败问题求助

问题重现 #

未修改项目CMake配置，仅替换为Ubuntu 20 + GCC 11环境构建的新版OpenCV库后，出现以下异常：

• 所有OpenCV库均存在于/LOCAL_FOLDER/OpenCV/lib/x64/目录，且CMake已通过OPENCV_LIB变量引入所有库完成链接
• 执行ldd检查最终可执行文件时，部分库（如libopencv_features2d.so.406、libopencv_flann.so.406）显示not found，其余库可正常定位
• 直接对这些"not found"的库执行ldd，发现其自身的部分依赖也无法找到
• 切换回Ubuntu 18 + GCC 8环境构建的旧版同版本OpenCV库，所有库均可被ldd正常识别，程序运行无问题

项目当前的OpenCV引入方式：
dependencies.cmake内容：

set(OPENCV_INCLUDE_DIR "/LOCAL_FOLDER/OpenCV/include") 
include_directories(${OPENCV_INCLUDE_DIR})
link_directories("/LOCAL_FOLDER/OpenCV/lib/x64/")
set(OPENCV_LIB ${OPENCV_LIB} *.so) # 实际包含所有库文件

子项目CMakeLists链接配置：

target_link_libraries(${PROJECT_NAME} ${OPENCV_LIB} "-Wl,--disable-new-dtags")
set_target_properties(${PROJECT_NAME} PROPERTIES INSTALL_RPATH "$ORIGIN")

核心原因分析 #

1. CMake库引用方式错误
   set(OPENCV_LIB ${OPENCV_LIB} *.so)中的通配符*.so不会被CMake自动展开，链接器实际是尝试查找名为*.so的库（而非所有后缀为.so的文件），导致部分库未被真正链接进可执行文件，仅作为间接依赖存在。

2. RPATH配置不完整

   • 仅设置了INSTALL_RPATH为$ORIGIN（可执行文件所在目录），但OpenCV库位于另一独立目录，该RPATH无法覆盖库的查找路径
   • 新版OpenCV构建时未配置CMAKE_INSTALL_RPATH，导致库自身的RPATH为空，库之间无法互相定位依赖（如libopencv_features2d.so无法找到同目录下的libopencv_core.so）

3. 新旧构建环境的链接行为差异
   Ubuntu 20 + GCC 11环境下，链接器默认行为（如DT_RUNPATH/DT_RPATH的优先级、RPATH默认配置）与Ubuntu 18 + GCC 8不同，旧版OpenCV构建时可能自动添加了正确的RPATH，而新版未配置。

解决方案 #

1. 修复CMake库引用逻辑 #

替换手动设置库列表的方式，改用OpenCV官方推荐的find_package，自动处理依赖链与路径：

# 在dependencies.cmake中替换原有配置
find_package(OpenCV REQUIRED PATHS "/LOCAL_FOLDER/OpenCV")
include_directories(${OpenCV_INCLUDE_DIRS})

子项目链接配置简化为：

target_link_libraries(${PROJECT_NAME} ${OpenCV_LIBS} "-Wl,--disable-new-dtags")

2. 配置正确的RPATH #

为可执行文件同时设置构建期与安装期的RPATH，指向OpenCV库目录：

set_target_properties(${PROJECT_NAME} PROPERTIES
    BUILD_RPATH "/LOCAL_FOLDER/OpenCV/lib/x64"  # 构建后直接运行时的库路径
    INSTALL_RPATH "/LOCAL_FOLDER/OpenCV/lib/x64" # 安装后的库路径
    BUILD_WITH_INSTALL_RPATH ON  # 构建时使用INSTALL_RPATH的配置
)

3. 修复OpenCV库自身的RPATH（可选） #

如果无法重新构建OpenCV，可使用patchelf工具手动为所有库添加RPATH：

# 批量为OpenCV库设置RPATH
patchelf --set-rpath '/LOCAL_FOLDER/OpenCV/lib/x64' /LOCAL_FOLDER/OpenCV/lib/x64/*.so

4. 临时验证（快速排查） #

通过环境变量临时指定库路径，验证是否为RPATH问题：

export LD_LIBRARY_PATH=/LOCAL_FOLDER/OpenCV/lib/x64:$LD_LIBRARY_PATH
./your_executable

若程序可正常运行，则可确认是RPATH配置问题。

验证步骤 #

1. 执行readelf -d <your_executable> | grep RPATH，检查可执行文件的RPATH是否包含/LOCAL_FOLDER/OpenCV/lib/x64
2. 重新构建项目后，再次执行ldd <your_executable>，确认所有OpenCV库均可正常定位
3. 直接运行程序，验证功能是否正常

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