MongoDB事务中文档锁定行为差异及客户端配置咨询

行为差异的核心原因 #

两种测试场景的本质区别在于是否使用ClientSession绑定操作，对应MongoDB两种不同的写处理逻辑：

• 第一种场景（非事务操作无会话）：无会话的独立写操作不会参与MongoDB的事务快照上下文。MongoDB的事务锁是与ClientSession绑定的乐观锁机制，无会话写操作直接跳过事务锁校验，直接修改文档最新版本。当原事务提交时，发现事务启动时的快照与当前文档版本不一致，就会抛出NoSuchTransaction异常——本质是事务的上下文已失效。
• 第二种场景（两个操作均用ClientSession）：第二个事务的写操作绑定了自己的会话，MongoDB会基于会话的快照进行乐观锁校验。当检测到目标文档已被另一个未提交事务修改时，就会触发预期的WriteConflict异常，这是事务会话间的并发冲突校验逻辑在起作用。

简单来说：无会话写操作不感知事务存在，直接覆盖修改；会话绑定的写操作会参与事务并发校验，触发冲突。

让第一种场景触发WriteConflict的配置方案 #

可以通过**强制非事务操作绑定ClientSession**来实现，具体步骤如下：

1. 在Spring Data中，为非事务的写操作显式创建并绑定ClientSession
2. 执行写操作时通过MongoTemplate.withSession(session)来调用，让操作纳入会话的快照上下文

示例代码：

// 初始化ClientSession
ClientSession session = mongoClient.startSession();
try {
    // 非事务更新操作绑定会话执行
    Query query = new Query(Criteria.where("_id").is("target-doc-id"));
    Update update = new Update().set("field", "new-value");
    mongoTemplate.withSession(session).updateFirst(query, update, YourDocument.class);
} finally {
    // 关闭会话
    session.close();
}

当非事务操作绑定会话后，MongoDB会基于会话的快照版本校验文档状态，若此时目标文档已被未提交事务修改，就会触发WriteConflict异常，和第二种场景的行为一致。

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