事务可见性、错误与重试边界

实现基线为 v4.2.5。事务模式、真实隔离级别、MySQL 兼容变量与数据新鲜度是不同维度;读取 @@transaction_isolation 的文本不能证明执行引擎采用了同名隔离策略。

时间戳和状态

值/状态

用途

诊断时需要核对

SnapshotTS

本次读取的版本边界

RC 的语句刷新与 SI 的事务快照不同

PrepareTS / CommitTS

TN 准备与提交排序

不与 UUID 事务 ID 或 WAL LSN 混用

Logtail 水位

CN 已同步的可读进度

与目标快照/最后提交比较

Committing / unknown

客户端正在提交或结果不明

网络错误不证明提交已失败

BEGIN → workspace / 读写 / 锁 → 准备与提交请求
                              ├→ 明确提交 → 释放事务资源
                              ├→ 明确中止 → 回滚/释放
                              └→ 结果未知 → 解析最终状态、避免盲目重复业务写入

悲观模式默认 RC、乐观模式默认 SI,需以运行时配置确认。RC 每个语句需要合适的快照,冲突后的内部语句重试不等于应用整事务可无条件重试。乐观冲突由 TN 的时间戳/MVCC 检查裁决,不能描述成提交时获得悲观锁。

错误范围

情况

默认处理原则

应用处理

普通约束/语法等语句错误

mo_rollback_txn_on_error=0 时回滚失败语句,事务可仍打开

明确选择继续、COMMIT 或 ROLLBACK

死锁、锁超时、绑定变化和部分连接/事务状态错误

静态错误集合要求整事务结束

重新开始事务,检查错误类型与幂等性

mo_rollback_txn_on_error=1

真实语句错误触发整事务回滚

不能继续把后续操作当作原事务

提交返回不明确

可能尚不能判断是否生效

用业务幂等键/状态核对,不能仅按网络错误重放

以错误号和 SQLSTATE 分类,并保存事务 ID;不要依赖错误消息文本中的一个关键词。后台/内部执行会话也有自身变量与生命周期,不能简单等同于普通客户端会话。

锁与节点变化

CN 的 LockService 管理本地锁表并代理远程锁。TN 的分配器维护锁表绑定版本;事务提交时绑定过期可导致中止。CN 下线、锁持有者失联和 TN 重建需要可靠性处理;“缓存无状态”不表示活跃事务无状态。

死锁和锁等待不是 WAL 等待。记录锁表/服务 ID、等待者和持有者、绑定版本以及事务时间范围,再结合锁服务日志诊断。

跨 CN 可见性

源 CN 的提交确认、目标 CN 的 Logtail 应用和目标事务选择快照分别发生。同会话读自己的提交、同 CN 新连接与另一 CN 新连接不能互相替代测试。重连后需重建订阅状态;通过端口健康检查不证明水位已追平。

参见 事务用法、隔离级别和 Logtail。

源码与回归入口