Go 在 Ubuntu 编译时网络问题的排查与解决
一、快速定位问题
- 确认网络连通性与目标站点可达：对模块域名执行 curl 探测，例如 curl -v https://google.golang.org/protobuf；若超时或握手失败，多半是网络被限制或 DNS 异常。
- 检查本机 DNS：临时写入公共 DNS，例如 echo “nameserver 8.8.8.8” | sudo tee /etc/resolv.conf，再重试构建。
- 排除防火墙/公司代理干扰：确认没有拦截 443 端口，或正确配置了企业代理（HTTP/HTTPS）。
- 若仅需验证环境而非拉取模块，可先运行一个最小程序：go run main.go；能运行说明工具链基本正常，问题集中在模块拉取环节。
二、最常见原因与一键修复
- 原因：编译触发 go mod 下载依赖，访问 proxy.golang.org 或某些域名超时（常见于部分地区网络）。
- 解决：启用模块并配置国内或可用代理，优先使用 goproxy.cn：
- 启用模块与代理：go env -w GO111MODULE=on && go env -w GOPROXY=https://goproxy.cn,direct
- 若此前设置过代理但以系统环境变量为准，需同步修改系统环境（例如在 /etc/profile 或 shell 配置中导出 GOPROXY），避免与 go env -w 冲突。
- 再次构建：go build 或 go mod tidy
- 备选代理：GOPROXY=https://goproxy.io,direct 或 GOPROXY=https://mirrors.aliyun.com/goproxy,direct（如直连失败可尝试）。
三、仍无法拉取时的进阶处理
- 关闭校验（仅在确认安全可信的网络中临时使用）：go env -w GOSUMDB=off，规避无法访问官方校验服务导致的失败。
- 手动获取关键模块：go get 包名@版本（如 go get google.golang.org/protobuf@v1.30.0），绕过模块代理直接拉取。
- DNS 污染或解析异常：更换为 8.8.8.8 等公共 DNS 后重试。
- 企业网络限制：配置 HTTP_PROXY/HTTPS_PROXY（例如 export HTTPS_PROXY=http://user:pass@proxy:port），确保 Go 与 git 均走同一代理。
- 极端情况（不建议长期使用）：修改 /etc/hosts 绑定域名与 IP，仅在确认 IP 正确且稳定时使用。
四、验证与常用命令清单
- 查看与写入配置：go env（查看）、go env -w KEY=VALUE（写入持久化配置）。
- 代理与模块开关：go env -w GOPROXY=https://goproxy.cn,direct；go env -w GO111MODULE=on。
- 校验开关：go env -w GOSUMDB=off（临时关闭）。
- 连通性测试：curl -v https://google.golang.org/protobuf；必要时 ping 目标域名。
- 最小环境自检：go version；go run main.go；go mod init test && go get rsc.io/quote && go run main.go。
