目錄
解決 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-mdRUN 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，可極大提升構建效率和穩定性。
)
)
