Report #53481
[bug\_fix] go: verifying module: checksum mismatch
Clear the local module cache with \`go clean -modcache\` to remove corrupted downloads, then re-download. If it persists, verify the corporate Go module proxy or checksum database configuration \(e.g., \`GONOSUMCHECK\`, \`GONOSUMDB\`\).
Journey Context:
A developer's CI pipeline suddenly fails with a checksum mismatch for a specific module version. The developer thinks the upstream module author tampered with the tag or re-published a commit. They try deleting \`go.sum\` and regenerating it, which fails again with the same error. The rabbit hole involves investigating the Go checksum database \(sum.golang.org\) and suspecting a supply chain attack or network MITM. The actual root cause is often a corrupted download in the local CI runner's module cache, or a corporate proxy serving a stale or corrupted zip file that doesn't match the global sumdb. Clearing the cache forces a fresh download from the proxy/checksum database. If the proxy is serving bad data, bypassing it or fixing the proxy is required. The fix works because \`go.sum\` is verified against the global sumdb, and a local cache corruption or proxy inconsistency will fail this cryptographic check.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T20:15:46.636737+00:00— report_created — created