如何为C++可执行文件构建无需拷贝全部依赖的Docker镜像

静态链接完全可以解决你遇到的依赖问题。你之前拷贝.so文件失败通常有两个核心原因：

1. ldd只能查询到程序启动时预加载的动态依赖，无法识别代码中通过dlopen动态加载的依赖库
2. 主机和容器的系统核心库（比如glibc）版本不匹配，就算拷贝了对应.so文件也会因为符号版本不兼容报错

静态链接会把所有依赖的库代码直接打包进可执行文件，运行时不需要额外加载外部动态依赖，最终生成的单文件可执行程序甚至可以直接在空容器镜像中运行。

• 提前准备依赖的静态库版本：确保所有依赖都有后缀为.a的静态库文件，通过apt安装的系统依赖一般包含在对应xxx-dev开发包中，部分发行版需要单独安装xxx-static包。
• 修改CMakeLists.txt配置：
  如果你需要全局开启静态编译，在CMakeLists.txt最开头添加以下配置：

  # 优先查找静态库而非动态库
  set(CMAKE_FIND_LIBRARY_SUFFIXES .a)
  # 关闭默认生成动态库的选项
  set(BUILD_SHARED_LIBS OFF)
  # 给可执行文件添加静态链接参数
  set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -static")
  

  如果你只需要给特定目标开启静态编译，不用修改全局配置，针对单个目标单独设置即可：

  add_executable(my_prog main.cpp xxx.cpp)
  target_link_options(my_prog PRIVATE -static)
  

• 编译验证：执行常规CMake构建流程

  mkdir build && cd build
  cmake ..
  make -j$(nproc)
  

  编译完成后执行ldd ./my_prog验证，如果输出not a dynamic executable或者没有任何.so依赖输出，说明静态链接成功。

静态链接完成后可以直接用精简镜像部署，无需安装额外依赖，Dockerfile示例如下：

# 用空镜像作为基础，体积最小
FROM scratch
COPY my_prog /my_prog
# 如果程序需要配置、证书等资源，也一并拷贝
# COPY config.yaml /config.yaml
ENTRYPOINT ["/my_prog"]

如果遇到部分依赖只有动态版本无法静态链接的情况，可以改用和主机系统版本完全一致的Ubuntu作为基础镜像，在镜像内直接安装所有依赖的开发包，再拷贝可执行文件运行，也可以解决依赖不匹配的问题。

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