如何将go -ldflags作为参数传入Dockerfile构建Go镜像？

报错原因 #

你遇到的问题是shell引号解析逻辑导致参数拆分错误：当${GO_FLAGS}在RUN命令中展开时，shell会把-ldflags "-X <package-path>.BuildVersion=0.1.1-1"拆分成三个独立参数：-ldflags、"-X、<package-path>.BuildVersion=0.1.1-1"。而go build的-ldflags需要接收一个完整的字符串参数，因此会报错invalid value "\"-X" for flag -ldflags。

可行解决方案 #

方案一：拆分构建参数（推荐） #

如果只是传递版本号这类单一参数，直接拆分ARG更直观，避免引号处理：

1. 修改Dockerfile：

# from statement and other stuff
...
ARG BUILD_VERSION
# Build
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -ldflags "-X <package-path>.BuildVersion=${BUILD_VERSION}" -a -o manager main.go

2. 构建命令：

docker build --build-arg BUILD_VERSION=0.1.1-1 -t controller:test .

这种方式参数含义明确，Dockerfile可读性更高，无需处理复杂引号。

方案二：用eval解析命令（适合多参数场景） #

如果需要传递多个go build参数（不止-ldflags），可以用eval让shell重新解析完整命令行，正确处理引号：

1. 修改Dockerfile的RUN命令：

# from statement and other stuff
...
ARG GO_FLAGS
# Build
RUN eval "CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build ${GO_FLAGS} -a -o manager main.go"

2. 保持原构建命令不变：

docker build --build-arg GO_FLAGS='-ldflags "-X <package-path>.BuildVersion=0.1.1-1"' -t controller:test .

eval会重新解析整个命令字符串，确保-ldflags的参数被识别为一个整体。

方案三：使用shell位置参数传递（进阶） #

通过set --命令将GO_FLAGS拆分为位置参数，再传递给go build，确保参数正确拆分：

1. 修改Dockerfile：

# from statement and other stuff
...
ARG GO_FLAGS
# Build
RUN set -- ${GO_FLAGS} && \
    CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build "$@" -a -o manager main.go

2. 构建命令不变：

docker build --build-arg GO_FLAGS='-ldflags "-X <package-path>.BuildVersion=0.1.1-1"' -t controller:test .

这种方式利用shell的位置参数特性，避免直接展开变量时的引号解析问题。

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