Docker Entrypoint无法找到Zig编译的exchange可执行文件

问题原因 #

报错exec /runtime: no such file or directory但文件实际存在，核心原因是Zig编译的exchange可执行文件为动态链接格式，而debian:bullseye-slim镜像缺少其依赖的系统库。test容器正常是因为它的依赖库刚好被slim镜像包含，或者本身依赖更少。

验证方法 #

1. 在主机上检查exchange的依赖：

   ldd zig-out/bin/exchange
   

   如果输出显示依赖libc.so.6等动态库，说明是动态链接的；静态链接的可执行文件会提示not a dynamic executable。

2. 临时启动exchange容器查看依赖：

   docker run --rm -it --entrypoint bash your-exchange-image
   ldd /runtime
   

   会直接看到缺失的库文件。

解决方案 #

方案1：静态编译可执行文件（推荐） #

修改Dockerfile中的编译步骤，强制Zig生成静态链接的可执行文件，彻底摆脱系统库依赖：

FROM euantorano/zig:0.10.1 as zigbase

FROM zigbase as exchangebuild
COPY include /include
COPY src /src
COPY build.zig /build.zig
# 加入静态编译参数，指定目标系统和静态链接
RUN ["zig", "build", "-fstage1", "-Dtarget=x86_64-linux-gnu.2.31", "-Dstatic"]

FROM debian:bullseye-slim AS test
COPY --from=exchangebuild /zig-out/bin/test /test
ENTRYPOINT [ "/test" ]

FROM debian:bullseye-slim AS exchange
COPY --from=exchangebuild /zig-out/bin/exchange /runtime
ENTRYPOINT [ "/runtime" ]

也可以在build.zig中配置默认静态链接，避免每次编译手动加参数：

// 在build.zig的exe配置块中添加
exe.setTarget(.{
    .cpu_arch = .x86_64,
    .os_tag = .linux,
    .abi = .gnu,
});
exe.linkage = .static;

方案2：使用完整依赖的基础镜像 #

如果不想静态编译，改用debian:bullseye（非slim版）作为基础镜像，它包含完整的系统库：

FROM debian:bullseye AS exchange
COPY --from=exchangebuild /zig-out/bin/exchange /runtime
ENTRYPOINT [ "/runtime" ]

验证 #

重新构建镜像并启动：

docker-compose build
docker-compose up

此时exchange容器应该能正常启动运行。

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