`go run` fails because of replace directive

[Resteklicken]

Version

1.31.0

What happened?

I suddenly get an error from the go toolchain when it tries to download / run sqlc (see below).

Relevant log output

go run github.com/sqlc-dev/sqlc/cmd/sqlc@latest vet
go: github.com/sqlc-dev/sqlc/cmd/sqlc@latest (in github.com/sqlc-dev/sqlc@v1.31.0):
        The go.mod file for the module providing named packages contains one or
        more replace directives. It must not contain directives that would cause
        it to be interpreted differently than if it were the main module.
2026/04/20 08:08:44 exit status 1
exit status 1

Database schema

SQL queries

Configuration

Playground URL

No response

What operating system are you using?

Linux

What database engines are you using?

PostgreSQL

What type of code are you generating?

Go

[johan-kjolhede-kivra]

Confirming this also breaks go install on v1.31.0 with the same error:

$ go install github.com/sqlc-dev/sqlc/cmd/sqlc@latest
go: github.com/sqlc-dev/sqlc/cmd/sqlc@latest (in github.com/sqlc-dev/sqlc@v1.31.0):
    The go.mod file for the module providing named packages contains one or
    more replace directives. It must not contain directives that would cause
    it to be interpreted differently than if it were the main module.

Caused by this directive added in v1.31.0:

replace github.com/go-sql-driver/mysql => github.com/sqlc-dev/mysql v0.0.0-20251129233104-d81e1cac6db2

Worth noting that the install docs still recommend go install github.com/sqlc-dev/sqlc/cmd/sqlc@latest, so users following the official instructions will hit this. Pinning to @v1.30.0 works as a workaround.

[axbrunn]

Same here:

$ make build-linux-arm64
Generating SQLC code...
go run github.com/sqlc-dev/sqlc/cmd/sqlc@latest generate
go: github.com/sqlc-dev/sqlc/cmd/sqlc@latest (in github.com/sqlc-dev/sqlc@v1.31.0):
	The go.mod file for the module providing named packages contains one or
	more replace directives. It must not contain directives that would cause
	it to be interpreted differently than if it were the main module.
make: *** [Makefile:36: sqlc-gen] Error 1

[vaughany]

Same issue here.

[rubensantoniorosa2704]

@kyleconroy looks like 1.31.0 has two dependency issues.

MySQL: the replace to github.com/sqlc-dev/mysql added in 21e6557 breaks go install/go run ...@latest, because the Go toolchain explicitly disallows go install cmd@version for modules that contain replace directives in their go.mod (see for example golang/go#44840).

SQLite: as in #4399, updating to github.com/ncruces/go-sqlite3 causes an Xenv interface mismatch (*env missing Xstrtol), so sqlc generate with SQLite no longer builds.

Maybe a 1.31.1 that isolates or rolls back these dependency changes could help people using the default install and SQLite paths. Happy to help test any fix.

[kyleconroy]

Hey all, looking into this today. For now please reference the previous version.

After fixing it I'll make sure to add some tests to make sure this type of issue doesn't happen again.