gorm v2 连 postgresql 需显式导入 gorm.io/driver/postgres 及 _ "github.com/jackc/pgx/v5"，dsn 须用 url 格式并正确转义特殊字符、指定 sslmode、timezone 和 connect_timeout；gorm.open 不校验连接，需主动 db.exec("select 1") 探活。
直接用 gorm.Open 连 PostgreSQL，核心就两点：导入正确的驱动、拼对 DSN。GORM v2 不再内置数据库驱动，漏掉任一环节都会卡在 driver: unknown driver "postgres" 或连接超时却无报错。
必须显式导入 postgres 驱动（不是自动注册）
GORM v2 要求你手动选择并导入驱动，github.com/lib/pq 已趋于维护尾声，推荐用性能更好、支持 context 的 github.com/jackc/pgx/v5。但注意：导入方式不是 import "github.com/jackc/pgx/v5"，而是：
-
import "gorm.io/driver/postgres"—— 这是 GORM 官方封装的适配层，必须用它 -
_ "github.com/jackc/pgx/v5"或_ "github.com/lib/pq"—— 下划线导入触发驱动注册，否则postgres.Open()会失败 - 如果用
lib/pq，记得加sslmode=disable（本地开发），否则默认尝试 SSL 握手，PostgreSQL 未启用 SSL 时直接拒绝连接
DSN 格式必须严格匹配 postgres 驱动要求
不能照搬 MySQL 的 key=value 形式（如 user=root dbname=test）混用，postgres 驱动只认两种格式之一：URL 或纯 key=value，且参数名大小写敏感、顺序无关。常见错误包括：
- 密码含
@、$、/等特殊字符未做url.QueryEscape，导致解析截断（例如password=P@ssw0rd会被当成 host 的一部分） - 漏掉
port=5432，系统可能 fallback 到 5432，但某些 Docker 环境或云服务端口不同，显式写更稳 - 没加
TimeZone=Asia/Shanghai，time.Time字段存入/读出时区偏移为 +00，显示比本地晚 8 小时 - 生产环境缺
connect_timeout=5，网络抖动时 goroutine 卡死 30 秒才返回错误
推荐写法（URL 形式，易拼接、易 escape）：postgres://postgres:P%40ssw0rd@localhost:5432/mydb?sslmode=disable&TimeZone=Asia/Shanghai&connect_timeout=5
gorm.Open 返回 *gorm.DB 不代表连接成功
它只初始化配置，不拨号、不验证。哪怕 PostgreSQL 进程根本没启动，gorm.Open 也返回非 nil 的 *gorm.DB。第一次调用 .First()、.Create() 才真正建连——此时才 panic 或报错。上线前必须主动探活：
- 简单通用：
db.Exec("SELECT 1").Error或db.Raw("SELECT 1").Scan(&struct{}{}).Error - 用 pgx 驱动时可更精准：
db.Config.ConnPool.(*pgxpool.Pool).Ping(context.Background()) - 别依赖
db.Error判断连接状态——它是上一次操作的残留错误，不是当前连接快照
时区、JSONB、连接池这些细节容易被忽略
它们不阻断连接，但会导致数据错乱或性能骤降：
-
TimeZone必须出现在 DSN 中，GORM 不会从系统或 PostgreSQL 服务端自动同步时区 - 读写
jsonb字段，模型字段类型建议用[]byte（不是string），避免 UTF-8 解码失败或空格截断 - pgx 默认连接池最大 4 个连接，高并发场景下需显式配置
MaxConns: 20等参数，通过postgres.Open(dsn).WithOptions(...)传入
连接字符串里一个 = 写错、一个字符没 escape、一次探活跳过，都可能让服务上线后静默失败几个小时。别信“跑通就行”，每个参数都要有明确依据。
