go network_error ai_generated true

go: example.com/[email protected]: reading https://proxy.golang.org/example.com/module/@v/v1.0.0.mod: dial tcp: lookup proxy.golang.org: i/o timeout

ID: go/proxy-connectivity-timeout

Also available as: JSON · Markdown · 中文
80%Fix Rate
87%Confidence
0Evidence
2024-12-10First Seen

Version Compatibility

VersionStatusIntroducedDeprecatedNotes
1.11 active
1.12 active
1.13 active
1.14 active
1.15 active
1.16 active
1.17 active
1.18 active
1.19 active
1.20 active
1.21 active
1.22 active
1.23 active

Root Cause

Network connectivity to the Go module proxy is unavailable, often due to firewall restrictions, DNS issues, or proxy being down.

generic

中文

无法连接到 Go 模块代理网络,通常是由于防火墙限制、DNS 问题或代理宕机。

Workarounds

  1. 70% success Set GOPROXY=off to bypass proxy and fetch directly from VCS
    export GOPROXY=off && go mod download
  2. 80% success Use a different proxy or direct connection
    export GOPROXY=https://goproxy.io,direct && go mod download

Dead Ends

Common approaches that don't work:

  1. Retrying the same command repeatedly 90% fail

    Network timeout is likely persistent; retrying without fixing connectivity will continue to fail.

  2. Setting GOPROXY=https://proxy.golang.org,direct 50% fail

    This is the default; if the proxy is unreachable, it will still timeout before falling back to direct.