事务必须手动控制,Iris不提供自动commit/rollback封装;它仅负责HTTP请求生命周期,事务开启、提交、回滚均由底层DB驱动(如database/sql+pgx/mysql)控制,框架不干预也不自动回滚。

事务必须手动控制,Iris 不提供自动 commit/rollback 封装
Iris 本身不介入数据库层,它只负责 HTTP 请求生命周期;事务开启、提交、回滚全由你使用的 DB 驱动(如 database/sql + pgx / mysql)控制。框架不会帮你调 tx.Commit() 或 tx.Rollback(),也不会在 panic 时自动回滚——这点和 Django 或 Laravel 完全不同。
中间件里开事务 + ctx.Values() 传 tx 实例最常用
把 *sql.Tx 塞进上下文,后续 handler 和 service 层都能取到,避免层层传参。但要注意生命周期和错误传播路径:
- 在中间件中调用
db.Begin(),成功后用ctx.Values().Set("tx", tx)存入 - 务必在中间件末尾加
ctx.Next(),否则 handler 不执行,事务永远卡住 - handler 执行完后,在中间件 defer 里检查是否出错:若
ctx.IsStopped()为 true 或捕获了 error,就调tx.Rollback() - 否则调
tx.Commit()—— 但注意:Commit()也可能失败(如网络中断),需二次判断返回 error - 别把
tx存成指针或闭包,更不要存*sql.DB,它们不是请求级资源
路由 handler 里怎么安全取 tx 并用
不能直接用 ctx.Values().Get("tx") 然后断言,容易 panic。要用配套的 Get 方法并检查 ok:
tx, ok := ctx.Values().Get("tx").(*sql.Tx)
if !ok {
ctx.StopWithStatus(iris.StatusInternalServerError)
return
}
// 后续用 tx.QueryRow() / tx.Exec() 等
常见错误是 handler 里忘了判 ok,或者用了 ctx.Values().GetPointer() 这种不存在的方法。另外,所有 DB 操作必须用这个 tx 实例,不能混用 db.Query()(那会走新连接,脱离事务)。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
嵌套事务、Savepoint 要自己实现,Iris 不支持
Iris 没有 BeginTxWithContext 或 Savepoint 抽象层。如果业务需要部分回滚(比如主流程失败但日志要记),得靠底层驱动支持:
- PostgreSQL:用
tx.Exec("SAVEPOINT sp1")和tx.Exec("ROLLBACK TO SAVEPOINT sp1") - MySQL:同理,但注意 autocommit 模式下 savepoint 行为略有差异
- 别依赖
tx.Stmt()自动绑定——它不保证跨语句事务一致性,显式用tx.Prepare()更稳 - 事务超时必须由你自己控制:启动时设
context.WithTimeout,传给db.BeginTx(),而不是靠 Iris 中间件超时
最容易被忽略的是:事务结束(commit/rollback)后,tx 对象不能再复用;但 ctx.Values() 里还留着旧指针,后续 handler 若没校验就直接用,会 panic 或静默失败。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!










