在arm64架构运行DotNet Docker镜像遇exec format error问题排查

核心原因 #

exec /opt/czertainly/entry.sh: exec format error 本质是脚本无法被目标arm64架构的系统正确解析执行，常见触发点包括：

• 脚本的shebang行无效或缺失
• 脚本使用Windows风格CRLF换行而非Linux风格LF
• 构建过程中脚本被错误地以amd64架构上下文处理
• 脚本执行权限未正确设置

针对性排查步骤 #

1. 检查entry.sh本身 #

• 验证shebang行：确保文件第一行是#!/bin/sh或#!/bin/bash（对应容器内的shell环境），缺失或错误的shebang会导致系统无法识别执行方式。
• 检查换行格式：用cat -A entry.sh查看，若每行结尾是^M$（CRLF），则需转换为LF（仅$结尾）。Windows环境下编辑的文件默认是CRLF，arm64 Linux系统无法解析这种格式的脚本。
• 确认执行权限：脚本必须具备可执行权限，否则即使格式正确也无法运行。

2. 检查Dockerfile配置 #

• 确保添加脚本权限设置及可选的换行修复：

  COPY entry.sh /opt/czertainly/entry.sh
  RUN chmod +x /opt/czertainly/entry.sh
  # 修复CRLF换行问题（若需要）
  RUN sed -i 's/\r$//' /opt/czertainly/entry.sh
  

• 确认基础镜像为多平台镜像：比如官方DotNet基础镜像mcr.microsoft.com/dotnet/aspnet:6.0支持amd64/arm64，若使用自定义基础镜像需确保其为多平台架构。
• 避免在构建阶段执行amd64专属二进制：若Dockerfile中有RUN调用仅amd64可用的工具，会导致arm64镜像中混入不兼容内容。

3. 检查GitHub Actions构建脚本 #

• 确保启用Docker Buildx并正确指定多平台：

  - name: Set up Docker Buildx
    uses: docker/setup-buildx-action@v3
  
  - name: Build multi-platform image
    uses: docker/build-push-action@v5
    with:
      context: .
      platforms: linux/amd64,linux/arm64
      push: true
      tags: your-registry/your-image:latest
  

• 确认构建上下文未被污染：若仓库中entry.sh是CRLF格式，需在构建前转换（比如添加run: dos2unix entry.sh步骤），避免Windows环境下的文件格式带入镜像。

验证修复结果 #

构建完成后，可通过以下命令确认镜像架构正确性：

# 查看镜像支持的架构
docker buildx imagetools inspect your-registry/your-image:latest
# 拉取arm64版本并验证
docker pull --platform linux/arm64 your-registry/your-image:latest
docker run --rm --platform linux/arm64 your-registry/your-image:latest /bin/sh -c "echo hello"

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