gorm.open连postgresql直接panic，主因是dsn格式错误（缺host/port/user/password/dbname或未加sslmode=disable）或未下划线导入gorm.io/driver/postgres驱动。
gorm.Open 连 PostgreSQL 直接 panic？先检查 DSN 和驱动导入
绝大多数连接失败不是代码逻辑问题，而是 dsn 字符串拼错或驱动没导入。GORM v2 要求显式导入 gorm.io/driver/postgres，且必须用下划线空白导入：_ "gorm.io/driver/postgres"，否则 postgres.Open 返回 nil，gorm.Open 直接 panic。
常见错误现象：failed to connect database: failed to initialize database, got error unsupported driver: postgres 或空指针 panic。
-
host、port、user、password、dbname缺一不可；本地开发时sslmode=disable必须显式加上，否则默认尝试ssl=required，连不上就卡住 - 时区建议统一设为
TimeZone=Asia/Shanghai，避免时间字段写入/查询偏差 - 密码别硬编码，改用
os.Getenv("DB_PASSWORD")读取，配合.env文件管理
AutoMigrate 不建表？确认模型结构和 GORM 标签
AutoMigrate 不是“自动同步”，它只做“单向创建”：有表就跳过，没表才建；字段少就加，字段多不删，类型不一致也不改。改了 struct 但表已存在，AutoMigrate 不会帮你更新字段类型或加索引。
- Go struct 字段名首字母必须大写（导出），否则 GORM 无法映射
- 主键必须叫
ID（大写）或显式加gorm:"primaryKey"标签；PostgreSQL 表里默认是id列，但 GORM 生成 SQL 时可能用错名 - 想让字段对应 PostgreSQL 的
jsonb类型，得加gorm:"type:jsonb"；想加唯一约束，写gorm:"uniqueIndex"，不能只靠 struct tag 名字猜
事务手动控制时 db.Begin() 后忘了 Commit() 或 Rollback()
GORM 的事务不是自动提交的。db.Begin() 返回一个新 *gorm.DB 实例，所有后续操作（Create、Save、First 等）都必须在这个实例上调用，最后必须显式 Commit() 或 Rollback()。漏掉任一环节，事务就挂起，连接可能被占住，甚至锁表。
- 别在 defer 里无条件
Rollback()，要判断err != nil再触发 - 事务内嵌套调用其他函数时，记得把事务 db 实例传进去，而不是用全局
db - 长时间未提交的事务容易被 PostgreSQL 的 idle_in_transaction_session_timeout 杀掉，报错类似
ERROR: canceling statement due to user request
部署到云服务器后连不上数据库？重点查三处网络配置
本地能连、云上连不上，90% 是网络层拦住的。Gin 本身不处理网络策略，全靠你配。
- 阿里云 ECS 安全组：确认入方向放行了数据库端口（如 PostgreSQL 的
5432），源地址别只写127.0.0.1，要填实际应用服务器 IP 或0.0.0.0/0（测试阶段） - PostgreSQL 配置文件
pg_hba.conf：确保有类似host all all 0.0.0.0/0 md5的行，并重载配置（pg_ctl reload或重启服务） - PostgreSQL
postgresql.conf中listen_addresses不能是localhost，得设成*或具体内网 IP，否则只监听本地回环
真正容易被忽略的是 pg_hba.conf 的匹配顺序——规则从上到下生效，靠前的拒绝规则会拦截后面的允许规则。改完务必重载，别只改不 reload。
