本文详解如何使用 gorm 在 postgresql 中显式设置事务隔离级别为 repeatable read，包括正确调用方式、兼容性说明、潜在陷阱及生产环境建议。
本文详解如何使用 gorm 在 postgresql 中显式设置事务隔离级别为 repeatable read，包括正确调用方式、兼容性说明、潜在陷阱及生产环境建议。
在 PostgreSQL 中，REPEATABLE READ 是一个强一致性隔离级别（实际语义等价于 SQL 标准中的 SERIALIZABLE），能有效防止不可重复读和幻读。但需注意：GORM 本身不提供跨数据库的抽象化隔离级别设置接口——其 Session(&gorm.Session{IsolationLevel: ...}) 仅对 MySQL 和 SQL Server 生效，对 PostgreSQL 无效。因此，必须通过原生 SQL 显式设置。
✅ 正确做法：在事务内执行 SET TRANSACTION ISOLATION LEVEL
在开启事务后、执行业务逻辑前，立即调用 tx.Exec() 执行 PostgreSQL 原生命令：
func CreateAnimalsWithRepeatableRead(db *gorm.DB) error {
tx := db.Begin()
defer func() {
if r := recover(); r != nil {
tx.Rollback()
}
}()
// 关键：显式设置隔离级别（必须在 BEGIN 后、任何 DML 前）
if err := tx.Exec("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ").Error; err != nil {
tx.Rollback()
return fmt.Errorf("failed to set isolation level: %w", err)
}
if err := tx.Create(&Animal{Name: "Giraffe"}).Error; err != nil {
tx.Rollback()
return err
}
if err := tx.Create(&Animal{Name: "Lion"}).Error; err != nil {
tx.Rollback()
return err
}
return tx.Commit().Error
}⚠️ 重要注意事项：
- SET TRANSACTION ISOLATION LEVEL 必须在事务内执行，且不能在任何数据操作语句（如 SELECT/INSERT）之后，否则 PostgreSQL 将报错：SET TRANSACTION ISOLATION LEVEL must be called before any query。
- 该命令仅影响当前事务，无需手动恢复，事务结束即失效。
- 确保使用的是 *gorm.DB 的事务对象（*gorm.Transaction），而非普通 DB 实例。
? 替代方案：使用 sql.Tx 原生控制（更底层、更可控）
若需更高灵活性或调试隔离行为，可绕过 GORM 事务封装，直接使用 database/sql 的 *sql.Tx：
func CreateWithRawTx(db *gorm.DB) error {
sqlDB, err := db.DB()
if err != nil {
return err
}
tx, err := sqlDB.BeginTx(context.Background(), &sql.TxOptions{
Isolation: sql.LevelRepeatableRead, // 注意：PostgreSQL 实际映射为 Serializable
})
if err != nil {
return err
}
defer tx.Rollback()
// 使用 tx.Query/tx.Exec 等原生方法
_, err = tx.Exec("INSERT INTO animals (name) VALUES ($1)", "Giraffe")
if err != nil {
return err
}
return tx.Commit()
}⚠️ 注意：sql.LevelRepeatableRead 在 PostgreSQL 驱动中会被自动转为 sql.LevelSerializable（因 PG 不支持标准 REPEATABLE READ），行为上等价，但语义标签不同。
✅ 最佳实践总结
- ✅ 始终在 Begin() 后、首个业务语句前设置隔离级别；
- ✅ 使用 tx.Exec() 而非 db.Exec()，确保作用于当前事务上下文；
- ✅ 添加 defer tx.Rollback() + recover() 防御 panic 导致事务悬挂；
- ❌ 避免依赖 gorm.Session{IsolationLevel:} 操作 PostgreSQL；
- ? 生产环境中建议配合 pg_stat_activity 或日志检查 backend_xmin/transaction_isolation 字段验证生效。
通过以上方式，你可以在 GORM + PostgreSQL 架构中精准控制事务一致性边界，为金融对账、库存扣减等强一致性场景提供可靠保障。
