ARM64机器构建Go多架构Docker镜像遇gcc '-m64'选项识别错误

问题分析 #

你遇到的gcc: error: unrecognized command-line option '-m64'错误，本质是在ARM64构建平台上交叉编译ARM64目标时，Go的CGO自动传递了x86_64架构的编译选项-m64，但ARM64的GCC工具链不支持该选项。同时你之前的Dockerfile存在两个关键问题：

• 针对linux/arm64目标安装了32位ARM的工具链（arm-linux-gnueabihf），而非64位ARM（aarch64-linux-gnu）的工具链
• 强行将GOARCH设为arm，混淆了32位和64位ARM架构，导致编译逻辑混乱

解决方案 #

修改Dockerfile中的工具链安装和编译命令部分，确保针对linux/arm64目标使用正确的64位ARM交叉编译工具，并覆盖Go自动生成的错误编译选项：

修改后的关键Dockerfile片段 #

FROM --platform=$BUILDPLATFORM golang:1-bookworm

ARG BUILDPLATFORM
ARG TARGETPLATFORM
ARG TARGETOS
ARG TARGETARCH

# ... 保留你的其他步骤（go mod tidy、vendor等） ...

ENV CGO_ENABLED=1
ENV GOOS=${TARGETOS}
ENV GOARCH=${TARGETARCH}

# 安装x86_64交叉编译工具（保留原有的amd64支持）
RUN apt update && apt install -y g++-x86-64-linux-gnu gcc-x86-64-linux-gnu libc6-dev-amd64-cross binutils

# 针对不同目标平台安装对应交叉编译工具
RUN case "${TARGETPLATFORM}" in \
    linux/amd64) : ;; # amd64无需额外安装，基础镜像或已安装的工具链足够 \
    linux/arm64) apt install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu libc6-dev-arm64-cross ;; \
    esac

# 分平台执行编译命令
RUN case "${TARGETPLATFORM}" in \
    linux/arm64) \
        # 覆盖GOGCCFLAGS，移除-m64，指定ARM64架构参数
        CC=aarch64-linux-gnu-gcc \
        GOGCCFLAGS="-march=armv8-a -fPIC -pthread -fmessage-length=0 -ffile-prefix-map=/tmp/go-build=/tmp/go-build -gno-record-gcc-switches" \
        go build -gcflags="-l -N" -o ./main ;; \
    *) \
        go build -o ./main ;; \
    esac

关键修改说明 #

1. 工具链修正：针对linux/arm64目标，安装gcc-aarch64-linux-gnu（64位ARM官方交叉编译工具），而非32位的arm-linux-gnueabihf工具链
2. 编译选项覆盖：通过GOGCCFLAGS手动指定ARM64兼容的编译参数，移除Go自动添加的-m64选项
3. 架构参数还原：不再强行设置GOARCH=arm，直接使用TARGETARCH传递的arm64，保证架构一致性
4. 条件判断优化：用case替代多个if，更清晰地处理多平台分支

额外注意事项 #

• 如果你的代码依赖sqlite3驱动，确保交叉编译时sqlite3的头文件和库文件也对应ARM64架构，可以通过以下命令启用multiarch并安装对应依赖：

  RUN dpkg --add-architecture arm64 && apt update && apt install -y libsqlite3-dev:arm64
  

• 所有apt install命令前务必执行apt update，避免出现包找不到的问题

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