生产环境必须用pgxpool.Pool，因其支持连接复用、健康检查、自动重连和context取消；pgx.Connect和sql.Open+lib/pq均不满足高并发与稳定性要求。
直接用 database/sql + pgx/v5 驱动，别碰已归档的 lib/pq；连接字符串必须带 sslmode=disable（开发）或 sslmode=require（生产），且 sql.Open 后必须立刻 db.Ping() 验证。
为什么 sql.Open("postgres", connStr) 会报 “unknown driver”？
因为没导入驱动包——database/sql 本身不实现任何数据库协议，只是接口层。你得显式导入并空白引用驱动才能注册它。
- 用
pgx/v5：写import _ "github.com/jackc/pgx/v5/database/sql"（注意下划线） - 别写
import "github.com/jackc/pgx/v5"——那是原生 pgx API，和database/sql不兼容 -
lib/pq已归档，GitHub 页面明确标为 “Deprecated”，新项目禁止使用 - 导入后仍报错？检查
go.mod是否真拉了github.com/jackc/pgx/v5，运行go mod tidy
连接字符串怎么写才不卡住或连不上？
PostgreSQL 默认强制 SSL，本地开发不加 sslmode=disable 就会卡在握手、超时后报 failed to connect: server does not support SSL；生产环境则必须用 sslmode=require 或更严模式。
- 推荐 URL 格式：
postgres://user:pass@localhost:5432/dbname?sslmode=disable - 密码含特殊字符（如
@、/）？先用url.QueryEscape(pass)处理再拼接 - Docker 环境里 host 别写
localhost——容器内localhost指自己，应填服务名（如postgres）或宿主机网关 IP（如172.17.0.1） - 云数据库（如 AWS RDS）端口不是 5432？必须显式写
:5433，不能依赖默认值
查数据时为什么 Scan panic 报 “unsupported Scan, storing driver.Value type ”？
这是 NULL 值扫进非指针/非 sql.NullXXX 类型的典型错误。PostgreSQL 的 NULL 不等于 Go 的零值，也不能直接扫进 *string 或 string。
- 字段可能为 NULL？一律用
sql.NullString、sql.NullInt64、sql.NullTime - 确定非空且是 TEXT/VARCHAR？用
&myVar（变量地址），不是&myPtr（指针变量的地址） - 时间字段扫出来是空？别用
time.Time，改用*time.Time或sql.NullTime - JSONB 字段不能扫进
string——会报cannot scan into *string from jsonb，改用json.RawMessage或自定义Scan方法
事务里执行第二条语句就报 “current transaction is aborted”？
PostgreSQL 的事务是强一致性模型：只要一条语句出错（唯一键冲突、类型转换失败等），整个事务立即进入 aborted 状态，后续所有命令全被拒绝，直到你显式 ROLLBACK。
- 每条
tx.Query/tx.Exec后都必须检查err != nil，一出错立刻tx.Rollback()并返回 - 别写
defer tx.Rollback()就完事——成功路径必须tx.Commit()，否则连接永远卡在idle in transaction - 事务内严禁混用
db.Query和tx.Query：前者走连接池新连，不在事务中，隔离性失效 - 用
pgxpool.Pool开事务，别用pgx.Connect——后者没有连接复用，高并发下直接dial tcp: too many open files
最易被忽略的一点：所有 PostgreSQL 连接配置（包括 sslmode、timezone、search_path）都得在连接字符串或 pgx.ParseConfig 里显式声明，pgx 不读环境变量、不自动 fallback、不猜你的意图。
