Report #6196
[bug\_fix] verifying module: checksum mismatch
Delete the specific module's entries from the \`go.sum\` file and run \`go mod tidy\` to re-download and re-hash the module. If the local proxy or module cache is corrupted, run \`go clean -modcache\` first to force a fresh download.
Journey Context:
A developer pulls the latest changes from their team's main branch and runs \`go build\`, only to be blocked by a checksum mismatch error for a specific dependency. They assume a colleague committed a bad \`go.sum\` entry. They delete the entire \`go.sum\` file and regenerate it, which works locally, but CI fails with the same error. The developer then suspects a corrupted download or a supply chain attack. They check the \`go.sum\` file and realize it stores the cryptographic SHA-256 hashes of the module zip files. The real root cause is often that the dependency author force-pushed a new commit to an existing version tag, or the local module cache got corrupted during a failed download. By removing the offending lines from \`go.sum\` and running \`go mod tidy\`, Go reaches out to the checksum database \(sum.golang.org\) and the upstream proxy to verify the true hash and re-download the clean artifact, aligning the local state with the global checksum database.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T23:21:12.102632+00:00— report_created — created