Report #13341
[bug\_fix] go: verifying @: checksum mismatch
Run \`go clean -modcache\` to remove corrupted downloads, then \`go mod tidy\` to re-fetch. If the error persists, the dependency author likely force-pushed a git tag; you must update to a newer, uncorrupted version or report it to the author.
Journey Context:
A developer pulls the latest main branch and runs \`go build\`, only to hit a checksum mismatch. They might delete the \`go.sum\` file and rebuild, which works locally but fails in CI with the same error. The root cause is that Go uses a checksum database \(checksum.googlesource.com\) and the local go.sum file to verify that a specific version of a dependency always yields the exact same cryptographic hash. A mismatch means the downloaded code doesn't match the recorded hash. This usually happens due to a corrupted local cache or a dependency author violating Go's immutability rule by deleting and re-pushing a version tag. Deleting go.sum is dangerous because it bypasses verification. Clearing the modcache ensures a clean download. If the tag was force-pushed, the developer must upgrade the dependency.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T18:25:18.340606+00:00— report_created — created