Docker多阶段构建C++应用时libblas.so.3找不到问题咨询

问题回顾 #

在多阶段构建C++应用时，运行阶段执行可执行文件报错：

./runScenarioTest: error while loading shared libraries: libblas.so.3: cannot open shared object file: No such file or directory

检查/lib/x86_64-linux-gnu/目录能看到libblas.a、libblas.so、libblas.so.3，但这些文件在ls中显示为红色，已尝试单独安装libblas-dev/liblapack-dev、添加ldconfig命令，问题仍存在。

红色文件的本质 #

ls中显示红色的.so文件不是归档文件（.a才是静态归档库），而是失效的软链接。软链接本身是指向另一个文件的指针，如果目标文件不存在，ls就会用红色高亮显示，这正是你遇到的情况。

问题根源 #

你在构建阶段安装的libatlas-base-dev是开发包，包含静态库、头文件和用于编译的链接文件，但这些文件的软链接可能指向构建阶段特有的路径。当你把整个/lib复制到运行阶段后，软链接的目标路径在运行阶段不存在，导致软链接失效，系统自然找不到真正的共享库文件。

另外，运行阶段不需要开发包，只需要运行时库，直接复制构建阶段的库目录会引入冗余且破坏依赖链。

正确解决方案 #

1. 拆分构建与运行阶段的依赖 #

构建阶段用开发包编译，运行阶段只安装运行时库，不要复制整个lib目录：

# 构建阶段：编译C++程序
FROM ubuntu:20.04 AS builder
RUN apt-get update && apt-get install -y build-essential libatlas-base-dev
WORKDIR /app
COPY . .
# 编译时链接BLAS/LAPACK库
RUN g++ -o runScenarioTest your_source_code.cpp -lblas -llapack

# 运行阶段：仅保留运行依赖
FROM ubuntu:20.04
# 安装BLAS运行时库（libatlas3-base是Ubuntu20.04上对应的运行时包）
RUN apt-get update && apt-get install -y --no-install-recommends libatlas3-base
WORKDIR /app
# 仅复制编译好的可执行文件
COPY --from=builder /app/runScenarioTest .
CMD ["./runScenarioTest"]

2. 验证软链接有效性 #

如果一定要复制库文件，需要确保软链接的目标在运行阶段存在。可以在构建阶段查看libblas.so.3的实际指向：

ls -l /lib/x86_64-linux-gnu/libblas.so.3

比如可能指向libblas.so.3.9.0，那么复制时需要同时复制目标文件和软链接，而不是整个/lib目录，但这种方式不如直接安装运行时库可靠。

3. 无需手动执行ldconfig #

在Ubuntu镜像中，安装软件包后会自动执行ldconfig更新库缓存，手动添加ldconfig通常无法解决软链接失效的问题。

总结 #

• ls中红色的.so文件是失效软链接，属于异常状态，直接导致运行时找不到库；
• 多阶段构建的核心是分离编译依赖和运行依赖，运行阶段只需安装对应运行时库，不要复制构建阶段的库目录；
• 使用libatlas3-base这类运行时包替代开发包，能保证依赖的完整性和正确性。

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