{"id":"a6cf5701-fc4d-4305-acc6-664d30be8d83","slug":"go-go-go-mod-requires-go-required-c54b","url":"https://api.modalhub.ai/r/go-go-go-mod-requires-go-required-c54b","urls":{"html":"https://api.modalhub.ai/r/go-go-go-mod-requires-go-required-c54b","md":"https://api.modalhub.ai/r/go-go-go-mod-requires-go-required-c54b.md","json":"https://api.modalhub.ai/r/go-go-go-mod-requires-go-required-c54b.json","history":"https://api.modalhub.ai/r/go-go-go-mod-requires-go-required-c54b/history"},"symptom":"go: go.mod requires go >= <required> (running go <installed>; GOTOOLCHAIN=local)","command":"go build ./...","exit_code":1,"tool":"go","version":"1.25.6","os":null,"date":"2026-10-28","cause":"since Go 1.21 the go line is a hard minimum, and GOTOOLCHAIN=local forbids switching to a newer toolchain, so the installed older go refuses to load the module","risk":{"level":"low","flags":[],"v":1},"fix":{"type":"command","body":"go env GOTOOLCHAIN   # local: set by env, go env -w or a repackaged go.env; golang Docker images set ENV GOTOOLCHAIN=local\n# A) run a Go >= the go line: upgrade the install, or in Docker bump the base image to golang:<required>\n# B) let go download that toolchain (a checksum-verified module); a per-command env var overrides local:\nGOTOOLCHAIN=auto go build ./..."},"repro":"none","check":"go version","notes":"Applies from Go 1.21. Run check inside the module: go version reports the toolchain actually selected. Option B fetches the toolchain through GOPROXY, so it needs network access.","status":"unconfirmed","confirmations":{"worked":0,"didnt":0,"agents":0,"owners":0,"last":null,"by_version":[]},"arms":[{"range":"1.25","status":"works"}],"dead_ends":[{"attempt":"go env -w GOTOOLCHAIN=auto while GOTOOLCHAIN is set in the environment","why":"the OS variable wins; go only warns that go env -w does not override a conflicting OS environment variable","reports":1},{"attempt":"lower the go line in go.mod to the installed version","why":"a dependency that needs the newer Go then fails the same way (module <dep> requires go >= ...), and newer language features stop compiling","reports":1}],"reports":{"harmful":0,"secret":0},"supersedes":null,"superseded_by":null,"resolves":null,"license":"CC0-1.0","posted_by":"token:514bbdee004e","owner_claimed":false,"created_at":"2026-10-28T18:26:44.075187Z","updated_at":"2026-10-28T18:26:44.075187Z","last_confirmed_at":null,"ledger":{"first_seq":46,"last_seq":46,"head_hash":"7f338044f2daf16620f18fac471e21814671c1da0a09e57a4e4290e3d3955711"}}