From f81047f9c9516fe0786c0891ba7840a7c2fd7a27 Mon Sep 17 00:00:00 2001
From: kennethcheng <a1478925630@163.com>
Date: Sun, 13 Sep 2026 18:34:51 +0800
Subject: [PATCH] =?UTF-8?q?fix(backend):=20Dockerfile=20=E5=8D=87=20Go=20b?=
 =?UTF-8?q?ase=20image=20=E5=88=B0=201.27-alpine=20=E5=8C=B9=E9=85=8D=20go?=
 =?UTF-8?q?.mod?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

NAS 部署时 builder 阶段 `go mod download` 失败:

  go: go.mod requires go >= 1.26.0 (running go 1.22.12; GOTOOLCHAIN=local)

根因:今天早上 `go mod tidy` 用本机 Go 1.27.0 跑,`go.mod` 的 go 指令
被写到 1.26.0(`go mod tidy` 行为:用当前 toolchain 的 minor),
但 `fuellog-api/Dockerfile` 写死 `FROM golang:1.22-alpine`,base 自带
Go 1.22.12,跟 go.mod 不一致 → Go 工具链自检不通过,go mod download
直接 exit 1。

GOTOOLCHAIN=local 也是这个错的成因:容器内默认不下载更新 toolchain,
如果 go.mod 要求的版本高于 base,会拒绝构建。要么升 base,要么放开
GOTOOLCHAIN=auto 走网络下载新工具链。升 base 是更确定的做法(无网也跑)。

修法:把 builder 阶段的 `FROM golang:1.22-alpine` 改成
`FROM golang:1.27-alpine`(与本机一致,与 go.mod 要求 >=1.26 都满足)。
runner 阶段 (alpine:3.20) 不需要 Go,不动。

未做(留待后续):
- 用 ARG 让 base Go 版本参数化,后续 `go mod tidy` 升 go.mod 时同步
  Dockerfile base。短期先写死 1.27
- 同样的"go.mod vs Dockerfile base"漂移问题可能在 web 那边再出现
  (目前 web 用 node:20-alpine,本机 node 24,node 不会因 minor 不一致
  拒绝 npm install,暂时没风险)
---
 fuellog-api/Dockerfile | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/fuellog-api/Dockerfile b/fuellog-api/Dockerfile
index 093259b..8df6c95 100644
--- a/fuellog-api/Dockerfile
+++ b/fuellog-api/Dockerfile
@@ -1,6 +1,8 @@
 # 多阶段构建:builder 出静态二进制,runner 极简
 # Builder
-FROM golang:1.22-alpine AS builder
+# 注:go.mod 的 go 指令是 1.26.0(本机 go mod tidy 用 Go 1.27 写入),
+# base image 必须 >= 1.26,否则 go mod download 会因 GOTOOLCHAIN=local 失败
+FROM golang:1.27-alpine AS builder
 
 # 国内构建场景下可换成 aliyun / tencent 镜像
 # RUN sed -i 's|dl-cdn.alpinelinux.org|mirrors.aliyun.com|g' /etc/apk/repositories