Gin框架整合PostgreSQL-Golang-PHP中文网

直接用gorm.open连postgresql会panic，主因是dsn格式错误或未下划线导入gorm.io/driver/postgres驱动；缺sslmode=disable、host/port/user/password/dbname任一参数，或驱动未注册，均导致unsupported driver或nil panic。

gin框架整合postgresql

直接用 `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")

`AutoMigrate` 不建表？确认模型结构、主键和 GORM 标签

AutoMigrate 不是“自动同步”，它只做“单向创建”：有表就跳过，没表才建；字段少就加，字段多不删，类型不一致也不改。如果你改了 struct 但表已存在，AutoMigrate 不会帮你更新字段类型或加索引。

容易踩的坑：

Go struct 字段名首字母必须大写（导出），否则 GORM 无法映射
主键必须叫 ID（大写）或显式加 gorm:"primaryKey" 标签，否则 GORM 默认用 id 小写字段，而 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()。漏掉任一环节，事务就挂起，连接可能被占住，甚至锁表。

典型错误写法：

Gin框架 1.9.0

Gin框架 1.9.0版本源码包下载，版本号 1.9.0，适合需要 sonic JSON 支持、路由修复和内容协商改进的 Go Web 开发场景。

下载

tx := db.Begin()
tx.Create(&user)
// 忘了 tx.Commit() → 连接未释放，下次请求可能卡住

正确做法是用 defer + error 判断：

tx := db.Begin()
defer func() {
    if r := recover(); r != nil {
        tx.Rollback()
    }
}()
if err := tx.Error; err != nil {
    tx.Rollback()
    return err
}
if err := tx.Create(&user).Error; err != nil {
    tx.Rollback()
    return err
}
return tx.Commit().Error