基于scratch构建Go镜像后程序无法读取文件的排查求助

我看你已经关闭了CGO，但还是碰到了文件找不到的问题，这大概率和Scratch镜像的“极简特性”以及你的构建配置有关，下面是几个最可能的原因和对应的解决办法：

1. 核心问题：文件根本没被复制到Scratch镜像里 #

Scratch镜像完全是空的——除了你手动通过COPY/ADD命令放进去的内容，它什么都没有。看你的Dockerfile，只复制了CA证书和Go二进制文件，完全没把./app/a.txt复制到最终镜像中！

解决方法：在Dockerfile的FROM scratch阶段，添加复制文件的步骤，比如：

FROM scratch
# 复制静态可执行文件
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
COPY --from=builder /go/bin/scratch /go/bin/scratch
# 新增：复制需要读取的文件到镜像对应路径
COPY --from=builder $GOPATH/src/scratch/app/a.txt /app/a.txt
# 运行二进制文件
ENTRYPOINT ["/go/bin/scratch"]

注意要确保在builder阶段（golang:alpine）里，$GOPATH/src/scratch/app/a.txt这个路径确实存在——你用了ADD . .，所以只要本地项目根目录下有app/a.txt，builder阶段就会有这个文件。

2. 相对路径解析错误：工作目录未设置 #

你的Go代码里用的是相对路径./app/a.txt，但Scratch镜像默认的工作目录是根目录/。当你运行/go/bin/scratch时，程序会从/目录开始解析相对路径，也就是找/app/a.txt；如果你的文件没放在这个位置，自然会报错。

解决方法有两种：

• 设置工作目录：在Dockerfile的FROM scratch阶段添加WORKDIR，比如：

  WORKDIR /go/bin
  

  这样程序运行时的当前目录是/go/bin，相对路径./app/a.txt会指向/go/bin/app/a.txt，这时候要把文件复制到对应位置。
• 改用绝对路径：把Go代码里的路径改成/app/a.txt，同时确保文件被复制到镜像的/app/目录下。

3. （少见但可能）文件权限问题 #

Scratch镜像没有用户管理系统，默认以root用户运行程序。如果你的a.txt在builder阶段的权限设置得过于严格（比如只有所有者可读，且所有者不是root），可能会导致程序无法读取。

解决方法：在builder阶段调整文件权限，比如：

RUN chmod 644 $GOPATH/src/scratch/app/a.txt

然后再复制到Scratch镜像中。

4. 大小写敏感问题 #

Linux环境（包括Docker镜像）是大小写敏感的，要确认本地的文件路径和代码里的路径完全一致——比如不要本地是./App/a.txt，代码里写./app/a.txt，这种情况也会导致文件找不到。

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