必须用pgx/v5替代已归档的lib/pq;sql.Open报“unknown driver”是因未导入驱动包,需import "github.com/jackc/pgx/v5"或import "github.com/jackc/pgx/v5/pgxpool";Scan NULL须用sql.NullString等,事务出错须立即Rollback。

别用 lib/pq 了,它已归档;现在必须用 pgx(尤其是 pgx/v5),否则连不上、扫不出、事务一错就卡死。
sql.Open("postgres", ...) 报错 "sql: unknown driver 'postgres'"
这不是连接字符串写错了,是根本没注册驱动。Go 的 database/sql 不自带 PostgreSQL 实现,必须显式导入驱动包并触发其 init() 函数。
- 用
pgx/v5兼容层:加import _ "github.com/jackc/pgx/v5"(注意下划线) - 用
pgxpool连接池(更推荐):加import _ "github.com/jackc/pgx/v5/pgxpool",然后用pgxpool.New,不是sql.Open - 删掉所有
import _ "github.com/lib/pq"—— 它在 2024 年底已被官方归档,不再维护,新项目禁用
Scan 时 panic: "unsupported driver -> Scan pair: []uint8 -> *string"
PostgreSQL 返回的文本字段底层是 []byte,而你用了 *string 或未初始化的 string 变量去接收,database/sql 拒绝自动转换。
- 字段可能为 NULL?一律用
sql.NullString、sql.NullInt64等,别用*string - 字段确定非空且是 TEXT/VARCHAR?用
&myVar(string变量地址),不是&myPtr(*string地址) - 更省心的做法:用
pgx.Row.ToStructByName,配合 struct tag 如pgx:"user_name",它自动处理 NULL 和类型映射
事务里第二条语句报 "current transaction is aborted, commands ignored until end of transaction block"
这是 PostgreSQL 的强一致性机制:只要事务中任意一条语句出错(比如唯一约束冲突、类型转换失败),整个事务立刻进入 aborted 状态,后续所有命令都被静默拒绝,直到你显式 ROLLBACK。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- 每条
tx.Query/tx.Exec后必须检查err != nil - 一旦出错,立刻
tx.Rollback(),然后 return 或抛错 —— 绝不能继续执行下一条 - 别依赖 defer tx.Rollback():它只在函数退出时调用,错误发生后继续跑会卡在 aborted 状态
本地开发连不上,psql 却能通
根本原因是 psql 默认走 Unix socket(匹配 pg_hba.conf 的 local 规则),而 Go 驱动默认走 TCP(触发 host 规则,常配成 ident 认证,但容器/WSL 里没有 ident 服务)。
- 开发环境首选 Unix socket:DSN 改成
postgres://user:pass@/dbname?host=/var/run/postgresql&sslmode=disable(路径按实际调整) - 或强制走 TCP 并改 pg_hba.conf:把
host all all 127.0.0.1/32 ident改成md5或trust(仅限本地) -
sslmode=disable必须显式加 —— 否则默认尝试 SSL,连不上就卡住或报server does not support SSL
最易被忽略的一点:现在没有“兼容旧代码”的余地。lib/pq 归档后,它的 DSN 解析、错误码、NULL 处理逻辑和 pgx 不一致,混用会导致行为漂移。从第一天就用 pgx/v5,别试图迁就老教程里的 $1 占位符写法之外的任何东西 —— 那些都过时了。


















