Docker使用scratch镜像报standard_init_linux.go:228错误排查咨询

1. 确认启动命令的执行形式 #

首先检查你的Dockerfile中CMD/ENTRYPOINT的写法：

• 如果使用shell格式（比如CMD ./your-go-app），Docker会默认调用/bin/sh -c来包裹你的启动命令，而scratch镜像没有自带/bin/sh，会直接触发该报错。
• 如果使用exec格式（比如CMD ["./your-go-app"]），会直接执行二进制，不会依赖shell。

可以执行以下命令查看镜像实际的启动配置，确认是否隐式调用了shell：

docker inspect your/image:tag | grep -A3 -B3 "Cmd\|Entrypoint"

2. 验证Go二进制的编译属性 #

即使你认为已经排除了依赖问题，也要再确认编译出的二进制是否为完全静态版本：Go默认开启CGO时，编译出的二进制会动态依赖系统libc和动态加载器，这些依赖在scratch中都不存在。
在宿主机执行以下命令检查二进制的动态依赖：

ldd ./your-go-app

如果输出中有任何not found的依赖项，说明是动态编译的，需要重新编译：

CGO_ENABLED=0 GOOS=linux go build -o your-go-app main.go

3. 校验镜像内部的文件结构 #

scratch为空镜像，很容易出现文件路径/权限配置错误的问题，可以通过导出镜像的方式直接查看内部结构：

# 导出镜像为tar包
docker save your/image:tag -o image.tar
# 解压tar包即可查看所有层的文件，确认二进制、依赖文件是否存在，路径是否正确

4. 精准定位缺失资源 #

如果上述步骤仍无法定位，可以用strace跟踪系统调用，直接找到缺失的文件：

strace -f docker run --rm your/image:tag 2>&1 | grep ENOENT

该命令会过滤所有「找不到文件/目录」的系统调用，输出结果会直接显示触发报错的缺失资源路径。

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