Go语言操作PostgreSQL指南

本文全面解析了在Go语言中正确操作PostgreSQL的关键实践与常见陷阱，强调必须彻底弃用已归档的lib/pq驱动，转而采用现代、高性能且维护活跃的pgx/v5（推荐pgxpool连接池），并深入讲解了驱动注册失败、“unknown driver”报错、NULL值安全扫描、事务异常后必须立即Rollback、本地连接认证失败等高频问题的根本原因与精准解法，同时指出pgx与旧驱动在DSN解析、错误处理和类型映射上的不兼容性——新项目务必从零开始遵循pgx/v5规范，避免踩坑。

别用 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。

• 每条 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 占位符写法之外的任何东西 —— 那些都过时了。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~