Report #3293
[bug\_fix] verifying github.com/some/[email protected]: checksum mismatch
Remove the stale \`go.sum\` entry and the cached module, then regenerate: \`go clean -modcache && rm go.sum && go mod tidy\`. If you are replacing the module with a local fork, pin the replace to a clean version tag or commit and ensure the local go.mod module path matches the replaced path. In CI, do not mix public proxy checksums with private fork checksums.
Journey Context:
A build that worked yesterday suddenly fails with a checksum mismatch. You suspect a re-tag or a poisoned proxy cache. The \`go.sum\` file contains a cryptographic hash of the module zip; if the tag was moved, the proxy rebuilt the zip with a different hash, or someone vendored a patched copy, the recorded hash no longer matches. You first try \`go mod tidy\`, but the bad entry persists because Go does not overwrite existing checksums silently. You delete \`go.sum\`, clear the module cache so no stale zip can win, run \`go mod tidy\` again, and the file is regenerated from the currently resolved sources. The build passes because every module is now hashed from the actual bytes being used.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T16:28:32.518619+00:00— report_created — created