Docker Compose下用-X链接标志注入Git提交Hash至Go二进制失败

问题根源分析 #

1. Dockerfile变量未解析：原构建命令用单引号包裹ldflags，Alpine的sh shell会将单引号内内容原样输出，不会展开$VERSION变量，导致最终注入的是字符串$VERSION。
2. Compose参数传递错误：原写法直接传递命令文本而非执行结果，且Windows shell（PowerShell/CMD）的命令替换语法与Linux bash不同，之前的$$(shell ...)写法不适用。

分步解决方案 #

1. 修正Dockerfile构建命令 #

删除多余的ENV VERSION=$VERSION（构建阶段直接用ARG即可），将ldflags的单引号改为双引号，并用${VERSION}明确引用变量：

# Build Stage
FROM golang:1.18-alpine3.16 AS builder
WORKDIR /app
COPY . .
ARG VERSION
# 用双引号包裹ldflags，确保变量被解析
RUN GOOS=linux GOARCH=amd64 go build -ldflags="-s -X main.version=${VERSION}" -o main ./cmd/api
RUN apk add curl
RUN curl -L https://github.com/golang-migrate/migrate/releases/download/v4.15.2/migrate.linux-amd64.tar.gz | tar xvz

# Run Stage（保持不变）
FROM alpine:3.16
WORKDIR /app
COPY --from=builder /app/main .
COPY --from=builder /app/migrate ./migrate
COPY app.env .
COPY start.sh .
COPY wait-for.sh .
COPY /migrations ./migration

EXPOSE 3001
CMD [ "/app/main" ]
ENTRYPOINT [ "/app/start.sh" ]

2. 修正Docker Compose参数传递 #

根据Windows使用的shell选择对应写法：

情况1：使用PowerShell

直接在docker-compose.yml中用PowerShell命令替换语法$(...)传递Git提交Hash：

version: "3.9"
services:
 postgres:
  build:
   context: .
   dockerfile: db.dockerfile
  environment:
   - POSTGRES_USER=root
   - POSTGRES_PASSWORD=secret
   - POSTGRES_DB=blogpost
  ports:
    - "542:5432"
 api:
  build:
    context: .
    dockerfile: app.dockerfile
    args:
      - VERSION=$(git describe --always --dirty)
  ports:
   - "3001:3001"
  environment:
   - DB_DSN=postgres://root:secret@postgres:5432/blogpost?sslmode=disable
  depends_on:
   - postgres
  entrypoint: [ "/app/wait-for.sh", "postgres:5432", "--", "/app/start.sh" ]
  command: [ "/app/main" ]

情况2：使用CMD

CMD无直接命令替换语法，需先手动获取Git Hash再传递：

1. 在CMD中执行以下命令获取Hash并设置环境变量：

for /f "delims=" %i in ('git describe --always --dirty') do set VERSION=%i

2. 修改docker-compose.yml的args部分，引用环境变量：

args:
  - VERSION=${VERSION}

3. 运行docker-compose build api完成构建。

3. 可选方案：Dockerfile内直接生成版本号 #

如果代码目录包含.git文件夹，可在builder阶段安装git自行生成版本号，无需从Compose传递参数：

# Build Stage
FROM golang:1.18-alpine3.16 AS builder
WORKDIR /app
COPY . .
# 安装git并生成版本号
RUN apk add --no-cache git
RUN VERSION=$(git describe --always --dirty) && GOOS=linux GOARCH=amd64 go build -ldflags="-s -X main.version=${VERSION}" -o main ./cmd/api
RUN apk add curl
RUN curl -L https://github.com/golang-migrate/migrate/releases/download/v4.15.2/migrate.linux-amd64.tar.gz | tar xvz

# Run Stage（保持不变）
...

验证方法 #

构建完成后启动容器，通过日志或接口输出检查main.version变量值，确认已正确注入Git提交Hash。

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