Couchbase AttemptContext事务异常 并发更新文档引发数据不一致

问题现象 #

• 事务块内存在多请求更新同一文档的逻辑时，并发线程更新会导致数据不一致
• 运行时输出如下警告：

[com.couchbase.core][IllegalDocumentState] Tried committing document <document_id>, but found that it has been modified by another party in-between staging and committing. The application must ensure that non-transactional writes cannot happen at the same time as transactional writes on a document. The change will be committed with CAS=0, which will overwrite the other change. This document may need manual review to verify that no changes have been lost. Last document state=cas=<CAS>,seqno=<SEQ_NO>,vbucket

• 最终影响：事务会以CAS=0强制提交覆盖其他写入，造成变更丢失、数据不一致，直接影响业务数据准确性。

触发根因 #

该警告本质是Couchbase事务的冲突保护机制触发：
Couchbase事务执行分暂存（staging）、提交两个阶段，正常流程下会基于CAS值做写入校验，保证提交时文档没有被意外修改。如果在暂存到提交的间隙文档被其他操作修改，就会触发该告警。
常见触发场景分两类：

• 文档同时存在事务写入、非事务普通KV写入两条路径，非事务写绕过了事务的锁保护修改了文档
• 事务内部逻辑错误：多线程共享同一个非线程安全的AttemptContext实例，在事务块内并发对同一文档发起更新，各自持有旧版本的文档快照做修改，破坏了事务内的版本校验逻辑
  默认配置下触发该冲突时，Couchbase不会回滚事务，而是直接用CAS=0强制覆盖写入，这就是数据丢失的直接原因。

修复方案 #

• 统一文档写入路径
  所有会被事务操作的文档，强制要求全量写入都走事务接口，禁止在事务执行周期内用普通非事务KV接口操作对应文档，从入口切断跨写入模式的冲突。
• 修正事务内并发逻辑
  禁止在同一个AttemptContext事务块内启动多线程并发操作同一文档：
  • 单事务内对同一文档的多次更新必须串行执行，每次修改前都读取事务上下文中的最新文档暂存状态，不要让多个线程各自持有旧版本文档副本做独立更新
  • 不要跨线程共享AttemptContext实例，该实例本身不做线程安全保证，每个独立事务执行流必须持有独立的上下文实例
• 调整冲突处理策略（可选）
  如果业务无法接受静默覆盖丢数据的风险，可以修改事务配置，把冲突后的默认处理策略从COMMIT_WITH_CAS_ZERO调整为FAIL_AFTER_RETRY，触发冲突时直接回滚事务后按业务逻辑重试，避免无提示的数据丢失。
• 存量数据修复
  拉取日志中所有触发过该告警的文档，对比文档历史版本做人工校验，补全被覆盖丢失的变更，修复存量不一致数据。

内容的提问来源于stack exchange，提问作者Maninder Chhabra