解决Docker-Compose运行时的执行格式错误、意外换行及权限拒绝问题

问题汇总 #

在Windows的WSL（Ubuntu 22.04）环境中，用Docker Compose部署Go服务时遇到三个问题：

• 执行CMD ["./second-service"]报错exec format error
• 改为ENTRYPOINT "./second-service"报错line 2: syntax error: unexpected newline
• 手动进入容器修正换行后执行二进制文件，遭遇permission denied

针对性解决方案 #

1. 解决exec format error #

该错误源于编译的二进制架构与容器架构不匹配，即使docker-compose指定了platform: linux/amd64，Go默认会以当前环境架构编译，若WSL宿主或本地编译环境与目标容器架构不一致，就会出现格式错误。

修正Dockerfile中的编译命令，强制指定目标平台：

RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o second-service

• CGO_ENABLED=0：禁用CGO，避免依赖系统动态库，保证二进制可移植性
• GOOS=linux/GOARCH=amd64：明确编译为Linux/amd64架构，与容器指定的平台完全匹配

2. 解决ENTRYPOINT语法错误 #

使用ENTRYPOINT "./second-service"这种shell格式时，若Dockerfile或代码文件带有Windows换行符（CRLF），容器内的shell会将\r解析为无效换行，导致语法错误。

两种修正方式：

• 改用exec格式的ENTRYPOINT（推荐，避免shell解析干扰）：

  ENTRYPOINT ["./second-service"]
  

• 统一文件换行符为LF：在WSL中执行dos2unix Dockerfile转换Dockerfile，或在编辑器（如VS Code）中设置文件换行符为LF。

3. 解决permission denied #

可能的原因包括文件权限继承自Windows共享目录、WORKDIR路径歧义、文件所有者不正确：

• 明确WORKDIR为绝对路径，避免路径歧义：

  WORKDIR /app
  

• COPY文件时指定所有者，确保容器内权限正常：

  COPY --chown=root:root . .
  

• 若代码存储在Windows挂载目录，建议将代码迁移到WSL原生目录（如/home/your-user/下），避免Windows文件系统的权限限制。

完整修正后的Dockerfile #

FROM golang:1.20-alpine3.17
WORKDIR /app
COPY go.mod .
COPY go.sum .
RUN go mod download
COPY --chown=root:root . .
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o second-service
EXPOSE 8080
RUN chmod +x ./second-service
CMD ["./second-service"]

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