基于scratch镜像构建Windows Docker容器启动失败问题排查

问题根源 #

scratch镜像完全是空的，不包含任何Windows系统组件：没有命令行解释器cmd.exe，没有系统依赖库，也没有默认的PATH环境变量。直接将hello.cmd设为启动命令时，Docker找不到能解析该脚本的程序，也无法定位脚本的执行环境，因此报错。

解决方案 #

需要手动向scratch镜像中添加执行批处理脚本必需的系统文件，并明确调用cmd.exe来执行脚本，具体步骤如下：

1. 修改Dockerfile

以下是可行的Dockerfile示例（路径需根据你的Windows系统实际情况调整）：

FROM scratch

# 复制cmd.exe及依赖的核心系统DLL文件
COPY C:/Windows/System32/cmd.exe /Windows/System32/cmd.exe
COPY C:/Windows/System32/kernel32.dll /Windows/System32/kernel32.dll
COPY C:/Windows/System32/msvcrt.dll /Windows/System32/msvcrt.dll
COPY C:/Windows/System32/advapi32.dll /Windows/System32/advapi32.dll

# 复制你的批处理脚本到容器根目录
COPY hello.cmd /hello.cmd

# 设置PATH环境变量，让系统能找到cmd.exe
ENV PATH="/Windows/System32:${PATH}"

# 明确调用cmd.exe执行脚本
CMD ["cmd.exe", "/c", "hello.cmd"]

2. 关键说明

• 必须提供cmd.exe及依赖库：批处理脚本需要cmd.exe来解析执行，而cmd.exe依赖多个系统DLL文件（如kernel32.dll、msvcrt.dll等），这些都需要手动复制到镜像中。
• 明确指定启动命令：不能直接将hello.cmd作为启动命令，必须通过cmd.exe /c来触发脚本执行（/c参数表示执行完脚本后退出命令行）。
• 路径匹配：复制的系统文件版本需与Docker Desktop使用的Windows容器OS版本匹配，避免兼容性问题。

简化版（无需设置PATH）

如果不想配置PATH，可以直接使用绝对路径调用所有文件：

FROM scratch

COPY C:/Windows/System32/cmd.exe /cmd.exe
COPY C:/Windows/System32/kernel32.dll /kernel32.dll
COPY C:/Windows/System32/msvcrt.dll /msvcrt.dll
COPY hello.cmd /hello.cmd

CMD ["/cmd.exe", "/c", "/hello.cmd"]

验证执行 #

重新构建并运行镜像：

docker build -t my-hello .
docker run -it my-hello

此时应该能正常输出Hello, World!。

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