如何使用buildx为树莓派Zero（armhf）交叉编译Go Docker镜像

错误码132对应SIGILL（非法指令），说明编译出的二进制包含树莓派Zero（ARMv6架构）不支持的指令。树莓派Zero基于ARM1176JZF-S内核，仅支持ARMv6指令集，不兼容ARMv7+指令，核心问题是编译时未正确指定ARM版本参数。

原Dockerfile的问题点 #

• 环境变量未持久化：RUN case ... export GOARM=...中的环境变量仅在当前RUN进程生效，后续go build无法继承该变量。
• TARGETVARIANT匹配错误：Docker buildx中linux/armhf对应的TARGETARCH为arm，TARGETVARIANT为v6，而非armhf，原case语句中"armhf"分支不会触发。

修改后的Dockerfile #

############################
# STEP 1 build executable binary
############################
FROM --platform=$BUILDPLATFORM golang:alpine AS builder
RUN apk update && apk add --no-cache git tzdata
WORKDIR $GOPATH/src/wimaha/teslaBleHttpProxy/
COPY . .
RUN go get -d -v

ARG TARGETOS
ARG TARGETARCH
ARG TARGETVARIANT
ARG TARGETPLATFORM

# 打印构建信息用于调试
RUN printf "Building for TARGETPLATFORM=%s, TARGETARCH=%s, TARGETVARIANT=%s\n" \
    "${TARGETPLATFORM}" "${TARGETARCH}" "${TARGETVARIANT}" \
    && printf "Host uname -s: %s, uname -m: %s\n" "$(uname -s)" "$(uname -m)"

# 统一设置GOARM参数，确保跨RUN生效
ENV GOARM=6
RUN case "${TARGETVARIANT}" in \
    "v7") export GOARM=7 ;; \
    esac && echo "Set GOARM=${GOARM}"

# 编译时继承GOARM环境变量
RUN CGO_ENABLED=0 GOOS=${TARGETOS} GOARCH=${TARGETARCH} GOARM=${GOARM} \
    go build -ldflags="-w -s" -o /go/bin/teslaBleHttpProxy

RUN mkdir -p /go/bin/key

############################
# STEP 2 build a small image
############################
FROM scratch
COPY --from=builder /usr/share/zoneinfo /usr/share/zoneinfo
ENV TZ=Europe/Berlin
COPY --from=builder /go/bin/teslaBleHttpProxy /teslaBleHttpProxy
COPY --from=builder /go/bin/key /key
EXPOSE 8080
ENTRYPOINT ["/teslaBleHttpProxy"]

优化后的构建命令 #

树莓派Zero对应linux/arm/v6（与linux/armhf兼容），可以单独构建测试或保留多平台构建：

# 单独构建树莓派Zero适配版本（本地测试用）
docker buildx build \
  --platform="linux/arm/v6" \
  --output=type=docker \
  -t wimaha/tesla-ble-http-proxy:dev-armv6 \
  .

# 推送到镜像仓库的多平台构建
docker buildx build \
  --platform="linux/arm/v6,linux/arm/v7,linux/arm64" \
  --output=type=registry \
  -t wimaha/tesla-ble-http-proxy:dev \
  .

验证步骤 #

1. 在树莓派Zero上拉取适配镜像：docker pull wimaha/tesla-ble-http-proxy:dev-armv6
2. 运行容器并查看日志：docker run --rm wimaha/tesla-ble-http-proxy:dev-armv6，确认是否正常启动。

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