Go 没有 @Transactional:同库 WithTx 与跨服务 Outbox

Hello,我是小兔大白糖。 从 Java 切到 Go,最别扭的不是少了一个 @Transactional 注解,而是突然发现:谁能开账、谁能关账、出错谁冲正——这些原来被框架代理藏起来的事,全摊在你手上了。漏一处 Rollback、在事务里打 HTTP、把整段请求包进一个巨型 tx,线上表现往往是锁等、脏数据或「我以为全回滚了」。写成这篇,给要做 Go 后端事务边界 调研、或要和 Spring 同事对齐「同库合同 vs 跨服务边界」的后端同学。
估计阅读时间:8 分钟
先给结论:语法不是痛点,边界才是
Go 没有 Spring 那种「方法上加注解就自动提交/回滚」的声明式事务,常见是显式 Begin / Commit / Rollback,或 ORM 提供的 Transaction 回调。两种栈都能把账做对;差别在于 Go 更逼你把 事务边界写清楚,不能指望 AOP 帮你圈范围。
读完这篇,我希望你能带走三件事:
- 同库多表 → 用「回调式 Unit of Work」(
WithTx一类)把边界收在一处。 - 跨服务副作用 → 别幻想全局
@Transactional;用短事务 + 幂等/补偿,或 Outbox / Saga。 - 六条硬规则 → 用来 Review PR 和排障,比争论「Go 有没有事务」有用得多。
若你还在 Go vs Java 栈选型 层面打转,可以先看姊妹篇:Go vs Java 后端选型。下文只谈 事务边界怎么签,不站队语言。
心智模型:会计日结,不是魔法报表
我习惯用 会计日结 想这件事:
| 视角 | 在做什么 | 你要负责的事 |
|---|---|---|
| 声明式(Spring 常见) | 签字权限绑在「这份报表模板」上——进模板就自动开账、结账 | 仍要懂传播行为、只读、回滚规则;只是边界常绑在方法上 |
| 显式(Go 常见) | 你亲手开账本、做分录、关账——错了自己冲正 | 边界必须函数化:一个入口开 tx,一个出口 commit/rollback,别复制粘贴 Begin 墙 |
这个比喻管 同库 ACID(一张账本里几笔分录要么全过、要么全撤)很顺手;管不了 跨机房、跨服务的「一张大账本」——分布式一致另有 Outbox、Saga 等套路,后面会单独说。
精确定义:什么叫「事务边界」
事务边界 = 从 Begin(或等价开始)到 Commit / Rollback 之间,共享同一数据库连接、同一 ACID 语义 的那段代码范围。
边界之内应满足:
- 操作的是 同一库(或同一分片内可同 tx 的资源);
- 错误向外返回 时,默认应 rollback(业务错误用
error,别用 panic 冒充); - 持锁时间尽量短:重 CPU、远程调用、发消息,默认不该堵在 tx 里。
边界之外:
- 已提交的写对其他连接 立即可见(隔离级别另论);
- 跨服务的 HTTP、支付、发 MQ 不能 被「本库 rollback」一起撤销——除非你做补偿或 Outbox,而不是加长 tx。
和 Java 对齐时,可以这么记:Spring 的 @Transactional 圈的是「方法级同库合同」;Go 里你要自己画出等价的圈,且更忌讳把圈画得比方法还大(整请求一条 tx)。
业界模式对照:A~D 怎么选
下面不是某框架说明书,是后端里 常见落法归纳(公开概念,可和同事核对)。
| 模式 | 典型做法 | 优点 | 代价 / 副作用 |
|---|---|---|---|
| A. 散落 Begin/Commit | 每个 handler / repo 方法手写开闭账 | 一眼能看见 SQL 生命周期 | 易漏 Rollback;边界难测;改连接策略要改 N 处 |
| B. 回调式 Unit of Work | db.Transaction(fn) 或自研 WithTx(ctx, fn);repo 只吃 tx | 边界一处;测试可注入 fake tx | 要纪律:tx 不能乱泄露;禁止「有时带 tx、有时不带」双路径 |
| C. 应用服务编排 + 短事务 | 业务步骤拆成多段短 tx + 幂等键 / 状态机 | 锁时间短,吞吐友好 | 中间态对外可见;必须设计补偿或重试语义 |
| D. Outbox / 消息驱动 | 同库写业务表 + outbox 表,异步投递 | 跨服务 可靠通知(最终一致) | 非强一致;消费者必须幂等;运维多一条投递链路 |
教学基线(多数 CRUD + 同库多表):
- 默认 B;
- 一旦副作用出网(通知、支付、别的微服务)→ C 或 D,别假装还能套一层「分布式 @Transactional」。
六条硬规则(Review 清单)
每条都是 可检验 的,不是「最佳实践」口号。
-
事务里只做同库工作
在 tx 内调不可回滚的外部 HTTP / 支付 / 第三方,且没有补偿设计 → 等于赌对方永远成功。失败时 只有库能回滚,对方可能已经扣款。 -
统一入口,单一路径
约定WithTx(ctx, fn)(名字可换,形态别换)。Repository 只接受tx或 ctx 里携带的 tx,禁止「有时直连db、有时用 tx」两套写法。 -
错误即回滚;panic 也要关账
fn返回error→ rollback。panic也要 defer rollback,但 业务校验失败请返回 error,别用 panic 当控制流——否则同事和监控都看不懂。 -
短持锁
重计算、批量组装 DTO、调 RPC,移到 tx 外;tx 里尽量只剩必要的写操作和紧耦合读。 -
只读与读写分开
纯查询别开写事务;能用只读连接 / 只读 hint 就别占写锁。常见误判:「反正都是读,包进 tx 省事」——白白拉长锁窗口。 -
跨服务:幂等 + Outbox / Saga,别造神话
需要「这边库成功、那边也要可靠发生」→ Outbox 或显式 Saga 步骤;不要发明不存在的「跨库 ACID 注解」。
示意:边界在内,副作用在外
全文尽量表格式说明;下面一段 伪流程 够用来对齐团队规范(不是可编译代码)。
WithTx(ctx, func(tx Tx) error {
create order row
deduct stock row
return nil // 成功 → commit
})
# commit 之后:发事件、扫 outbox、调 HTTP——都不在本 tx 的回滚范围内要点就两句:多表一致在 fn 里做完;出网的副作用在 commit 之后,并自带幂等或补偿。
若你团队用 ORM 的 Transaction 回调,语义相同:回调体 = 边界内,回调返回后的逻辑 = 边界外。
反模式:四类高频事故
结论:这些不是「Go 坑」,是边界没签好——Java 里 tx 划太大也一样。
-
每个 err 分支手写 Rollback
少写一处就 leak 连接或半提交。应收敛到 一个 defer / 一个回调出口。 -
tx 内调下游,失败以为「全回滚」
库撤了,对方接口可能已经 200。要靠 Outbox、幂等键、对账,不是靠加长事务。 -
巨型事务包住整段 HTTP 请求
从鉴权读到写库再到调三个 RPC,全在一个 tx 里——锁等、死锁、超时连锁。拆成 短 tx + 编排。 -
用框架魔法暗示跨库 ACID
多个数据源、分库分表、还想要「一个注解全提交」——在 Go 和 Java 里都应警惕:没有银弹,只有明确模式(2PC 极少用、Outbox/Saga 常见)。
选型小结:同库 B,跨服 C 或 D
| 场景 | 建议 | 别忘了的代价 |
|---|---|---|
| 同库多表强一致 | B:回调式 Unit of Work | 团队纪律:tx 传递方式统一 |
| 可接受中间态、要吞吐 | C:短事务 + 幂等 / 状态机 | 产品要能解释「处理中」 |
| 要可靠通知其他服务 | D:Outbox(+ 异步消费) | 最终一致;监控投递滞后 |
| 临时原型、极少改动的脚本 | A 可能够用 | 一上生产就倾向迁到 B |
可复述给同事的三句话:
- Go 缺的不是事务,是 显式边界——用
WithTx收口子。 - tx 里不要 HTTP;跨服务用 Outbox / Saga / 补偿,别装分布式声明式事务。
- 栈选型看语言生态;边界合同看架构——和 Go vs Java 后端选型 搭配读,不重复站队。