Docker部署C++应用时libDependency.so加载失败求助

核心问题 #

动态链接器找不到libDependency.so的原因是：该库所在的/ws/Dependency/lib/不在动态链接器的默认搜索路径中，同时你的应用编译时未指定该路径作为依赖搜索路径（rpath），也没有在容器中配置环境变量告知动态链接器该路径。

你COPY依赖时使用的带相对跳转的路径（/ws/MyApp/Module/../../Dependency/lib/libDependency.so）虽然最终能正确复制文件到目标位置，但这不是导致错误的原因，只是写法不够简洁，直接写/ws/Dependency/lib/libDependency.so更清晰。

解决方法 #

方法1：编译时添加rpath（推荐） #

在CMakeLists.txt中为你的应用目标添加rpath参数，让应用启动时自动去指定路径查找依赖：

# 假设你的应用目标名为MyApp
target_link_options(MyApp PRIVATE "-Wl,-rpath,/ws/Dependency/lib")

如果依赖路径是通过变量定义的，也可以用CMake的生成表达式保持灵活性：

target_link_options(MyApp PRIVATE "-Wl,-rpath,$<TARGET_FILE_DIR:${DEPENDENCY_LIB}>")

修改后重新构建镜像，应用启动时会自动识别依赖路径，无需额外配置。

方法2：容器中设置LD_LIBRARY_PATH环境变量 #

在Dockerfile中添加环境变量，告知动态链接器去指定路径找库：

ENV LD_LIBRARY_PATH="/ws/Dependency/lib:${LD_LIBRARY_PATH}"

或者在启动容器时临时指定：

docker run -e LD_LIBRARY_PATH=/ws/Dependency/lib your-image-name

方法3：复制依赖到动态链接器默认路径（不推荐） #

将依赖库复制到/usr/lib或/lib这类动态链接器默认搜索的目录：

COPY --from=builder /ws/Dependency/lib/libDependency.so /usr/lib/

这种方式简单，但可能会与系统自带库冲突，适合简单项目。

验证修改 #

重新构建镜像并启动容器后，执行以下命令确认依赖路径正常：

ldd /ws/MyApp/build/MyApp

如果libDependency.so的路径显示为/ws/Dependency/lib/libDependency.so（或你复制的目标路径），说明问题已解决。

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