Ubuntu 下 Golang 编译时的网络问题排查与解决
一 快速修复 使用国内模块代理
- 开启模块并配置代理（写入当前会话或持久化到用户环境）：
- 当前会话
- export GO111MODULE=on
- export GOPROXY=https://goproxy.cn,direct
- 持久化（推荐）
- go env -w GO111MODULE=on
- go env -w GOPROXY=https://goproxy.cn,direct
- 如依赖校验受阻，可临时关闭校验（仅在内网或可信源时）：go env -w GOSUMDB=off
- 再次编译：go build 或 go mod tidy
- 说明：上述代理适用于在中国大陆等访问 golang.org 及 proxy.golang.org 不稳定或超时的场景，能显著缓解模块拉取超时问题。
二 仍无法下载时的网络与 DNS 排查
- 基础连通性
- curl -Iv https://google.golang.org/protobuf
- ping google.golang.org（注意：某些 CDN 禁 ping，仅作参考）
- DNS 解析
- 查看 /etc/resolv.conf 是否存在有效的 nameserver
- 临时更换为公共 DNS：echo “nameserver 8.8.8.8” | sudo tee /etc/resolv.conf
- 若被系统服务（如 systemd-resolved、NetworkManager）覆盖，需改为在相应配置中设置 DNS 或使用其提供的接口
- 防火墙与出口策略
- 确认公司/校园网或云主机安全组未拦截 443 端口的出站连接
- 如使用代理或公司网关，确保相应例外已配置
- 说明：DNS 错误或防火墙拦截是模块下载失败的常见根因，优先排除可快速恢复编译。
三 使用 HTTP/HTTPS 代理的场景
- 若处于公司代理后，需为 Go 显式配置代理（HTTP/HTTPS 代理与 GOPROXY 不同）
- export HTTP_PROXY=http://proxy.company.com:8080
- export HTTPS_PROXY=http://proxy.company.com:8080
- 如代理需要认证：export HTTPS_PROXY=http://user:pass@proxy.company.com:8080
- 注意：Go 的模块代理走 GOPROXY，而 git 拉取（例如私有模块或某些 VCS）可能走 HTTP(S)_PROXY；两者需同时正确配置。
四 离线或受限环境的替代方案
- 使用国内镜像站点预先下载依赖
- GOPROXY=https://goproxy.cn,direct go get google.golang.org/protobuf@v1.30.0
- 使用 go mod vendor 将依赖打入项目
- go mod tidy
- go mod vendor
- 编译时加入 -mod=vendor 使用本地依赖：go build -mod=vendor
- 说明：在完全离线或高延迟网络下，vendor 能保证构建的可重复性与稳定性。
五 交叉编译时的网络相关注意
- 纯 Go 项目建议关闭 CGO，避免外部 C 库下载/编译带来的网络与依赖问题
- CGO_ENABLED=0 GOOS=linux GOARCH=mips go build main.go
- 体积优化可叠加：-ldflags=“-s -w”
- 说明：交叉编译时若启用 CGO，通常需要目标平台的 C 交叉编译链与头文件，网络与依赖复杂度会显著上升；无特殊需求时优先使用 CGO_ENABLED=0。
