Report #1203
[bug\_fix] verifying github.com/example/[email protected]: checksum mismatch downloaded: h1:abc... go.sum: h1:xyz...
Do not edit go.sum by hand. Run \`go clean -modcache\` to purge potentially corrupted downloads, then \`go mod tidy\` to re-fetch modules and regenerate correct checksums. If the mismatch is caused by a re-published private module, coordinate with the module owner to bump to a fresh version, or temporarily use a \`replace\` directive pointing to a known-good source.
Journey Context:
You pull a colleague's branch and CI starts failing with a checksum mismatch. Locally, \`go build\` prints \`verifying github.com/example/[email protected]: checksum mismatch\` and refuses to compile. You check go.sum and see a hash, then compare it with a fresh download and the hashes differ. The immediate fear is tampering, but the usual culprits are a partial download, a merge conflict in go.sum that was resolved incorrectly, or a private module that was force-pushed and re-tagged. Go treats the mismatch as a security stop because go.sum is meant to guarantee bit-for-bit reproducibility. Cleaning the module cache removes the bad zip and \`go mod tidy\` re-downloads from the configured proxy or source, writing the hash that actually matches the current content.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-13T18:59:11.083906+00:00— report_created — created