Fiber 不提供事务管理，因其定位为 HTTP 路由框架，不绑定数据库驱动，也不封装 BeginTx/Commit/Rollback；事务控制完全交由所选数据库客户端（如 database/sql、GORM）负责，Fiber 仅负责将请求生命周期与数据库连接/事务上下文串联起来。
为什么 Fiber 本身不提供事务管理
Fiber 是 HTTP 路由层框架，它不绑定任何数据库驱动，也不封装 BeginTx、Commit 或 Rollback 这类操作。事务控制完全交由你选用的数据库客户端（如 database/sql、pgx、gorm）负责。Fiber 的职责只是把请求生命周期和数据库连接/事务上下文串起来——关键在你怎么传递和清理。
在 Fiber 中正确开启并传播 *sql.Tx
不能在中间件里直接调 db.BeginTx() 然后塞进 c.Locals 就完事。常见错误是：没检查返回的 *sql.Tx 是否为 nil，或在 panic 后忘了 Rollback，又或者多个 handler 重复调 Commit 导致 sql: transaction has already been committed or rolled back。
- 用
c.Context().Value()或c.Locals传递*sql.Tx，但务必在 defer 中统一判断是否需要Rollback - 开启事务前先确认当前请求尚未持有有效事务（避免嵌套误开）
- 使用
context.WithTimeout控制事务最大持续时间，防止长事务阻塞连接池 - 示例片段：
tx, err := db.BeginTx(c.Context(), &sql.TxOptions{Isolation: sql.LevelReadCommitted}) if err != nil { c.Status(500).SendString("tx begin failed") return } defer func() { if r := recover(); r != nil || c.Response().StatusCode() >= 400 { tx.Rollback() return } if !c.Response().Committed { tx.Commit() } }()
用 GORM 时怎么让 Fiber 和 *gorm.DB.Transaction 兼容
GORM 的 Transaction 方法会自动处理 panic 回滚，但它返回的是新构建的 *gorm.DB 实例，不是原始 *sql.Tx。如果你在 Fiber handler 里混用原生 SQL 和 GORM 操作，必须确保它们共享同一个底层 *sql.Tx。
- 不要用
db.Transaction(func(tx *gorm.DB) error { ... })包整个 handler —— 它无法暴露*sql.Tx给其他非 GORM 代码 - 改用
db.Session(&gorm.Session{NewDB: true}).Transaction(...)配合手动传入*sql.Tx（需调db.Session(&gorm.Session{Context: c.Context(), SkipDefaultTransaction: true})） - 更稳妥的做法：统一用
db.BeginTx获取*sql.Tx，再通过db.Session(&gorm.Session{Context: c.Context(), NewDB: true}).WithContext(c.Context()).Session(&gorm.Session{NewDB: true}).Debug().Transaction(...)显式注入 - 注意 GORM v2 默认开启 prepare stmt，而某些驱动（如 pgx）在事务中复用 stmt 可能出错，建议关掉：
db.Session(&gorm.Session{PrepareStmt: false})
事务失败后如何避免 Fiber 返回空响应
最常被忽略的一点：事务内发生错误时，很多人只调 tx.Rollback()，却忘记显式写响应。Fiber 不会自动补 500，如果 handler panic 且没 recover，可能返回空 body + 200 状态码，前端完全感知不到失败。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
务必在所有错误分支中调 c.Status(xxx).SendXXX()，尤其是 rollback 后。更安全的方式是封装一个事务 wrapper：
func WithTx(db *sql.DB, fn func(*sql.Tx) error) func(c *fiber.Ctx) error {
return func(c *fiber.Ctx) error {
tx, err := db.BeginTx(c.Context(), nil)
if err != nil {
return c.Status(500).SendString("db begin failed")
}
defer func() {
if r := recover(); r != nil {
tx.Rollback()
c.Status(500).SendString("panic in tx")
}
}()
if err := fn(tx); err != nil {
tx.Rollback()
c.Status(400).SendString(err.Error()) // 或结构化 JSON
return nil
}
return tx.Commit()
}
}
然后在路由中：app.Post("/order", WithTx(db, handleOrder))。这样错误路径收口清晰，不会漏响应。
