开启CGO_ENABLED=1构建含go-sqlite3的Go Docker镜像失败求助

问题原因 #

M1芯片为arm64架构，Alpine的musl libc在该架构下默认未定义pread64/pwrite64宏，导致go-sqlite3的C绑定编译失败。

修改方案 #

方案一：添加编译宏定义（推荐） #

在构建阶段添加CGO_CFLAGS环境变量，强制启用大文件支持相关宏，让musl识别64位文件操作函数：

修改后的Dockerfile：

FROM golang:alpine
ENV CGO_ENABLED=1
# 添加宏定义，解决arm64架构下pread64/pwrite64未声明问题
ENV CGO_CFLAGS="-D_LARGEFILE_SOURCE -D_LARGEFILE64_SOURCE"

RUN apk add --no-cache \
    gcc \
    musl-dev

WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .

RUN go build -o ./server cmd/main.go

FROM alpine
COPY --from=0 /src/server /usr/bin/server
CMD ["server"]

方案二：明确指定构建平台 #

在Dockerfile开头指定arm64平台，避免架构适配问题：

FROM --platform=linux/arm64 golang:alpine
ENV CGO_ENABLED=1

RUN apk add --no-cache \
    gcc \
    musl-dev

WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .

RUN go build -o ./server cmd/main.go

FROM --platform=linux/arm64 alpine
COPY --from=0 /src/server /usr/bin/server
CMD ["server"]

或者在构建时直接传递平台参数：

docker build --platform linux/arm64 -t your-image-name .

方案三：改用Debian基础镜像（备选） #

Debian使用glibc，默认支持64位文件操作函数，无需额外宏定义：

FROM golang:bullseye
ENV CGO_ENABLED=1

WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .

RUN go build -o ./server cmd/main.go

FROM debian:bullseye-slim
COPY --from=0 /src/server /usr/bin/server
CMD ["server"]

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