解决 Go 构建依赖超时问题：使用 GOPROXY 提升 Docker 构建稳定性

目录

解决 Go 构建依赖超时问题：使用 GOPROXY 提升 Docker 构建稳定性

✅ 问题背景

✅ 正确做法：多阶段中在 Go 阶段设置 GOPROXY

✅ 实际收获

🧪 小技巧：验证 GOPROXY 设置是否生效

✅ 总结

---

解决 Go 构建依赖超时问题：使用 GOPROXY 提升 Docker 构建稳定性

在构建包含 Go 模块的项目时，很多国内开发者常常遇到如下错误：

Get "https://proxy.golang.org/...": dial tcp ...: i/o timeout

这是由于 Go 默认使用国外的模块代理 https://proxy.golang.org，在国内访问常常被墙或极慢，导致 go mod tidy、go build 失败。解决方法是使用国内代理源，如七牛的 https://goproxy.cn。

---

✅ 问题背景

项目使用了 Go 写的 HTML 转 Markdown 插件，作为 .so 库供主服务调用。Docker 构建流程如下：

FROM golang:1.24 AS go-base
ENV GOPROXY=https://goproxy.cn,direct
COPY sharedLibs/go-html-to-md /app/sharedLibs/go-html-to-md

RUN cd /app/sharedLibs/go-html-to-md && \
    go mod tidy && \
    go build -o html-to-markdown.so -buildmode=c-shared html-to-markdown.go && \
    chmod +x html-to-markdown.so

初始我们曾在前置 Node 阶段中设置：

ENV GOPROXY=https://goproxy.cn,direct

但因 FROM node:22-slim 并未安装 Go，此变量并未影响实际 go mod tidy 执行，导致依赖拉取仍失败。

---

✅ 正确做法：多阶段中在 Go 阶段设置 GOPROXY

只需将 ENV GOPROXY=... 放在 golang:1.24 阶段中：

FROM golang:1.24 AS go-base
ENV GOPROXY=https://goproxy.cn,direct
...

并确保在 go mod tidy 执行前生效。构建将稳定、快速完成。

---

✅ 实际收获

• 构建时间从数分钟下降至数十秒

• 完美解决 i/o timeout 报错

• 构建日志更干净，无需反复重试依赖

---

🧪 小技巧：验证 GOPROXY 设置是否生效

你可以加入调试语句查看：

RUN echo "Using GOPROXY=$GOPROXY"

构建日志输出如下即表示成功：

Using GOPROXY=https://goproxy.cn,direct

---

✅ 总结

构建时遇到 Go 网络超时问题，不是设置 GOPROXY 无效，而是设置的位置错了。确保在实际使用 Go 命令的阶段配置 GOPROXY，配合国内源如 https://goproxy.cn，可极大提升构建效率和稳定性。