Spring Boot中MongoDB多文档事务无法回滚问题求助

核心排查点及解决方案 #

1. 未启用Mongo事务支持 #

Spring Boot中使用Mongo事务必须显式开启支持，需在配置类或主启动类上添加@EnableMongoTransactions注解：

@SpringBootApplication
@EnableMongoTransactions // 必须添加此注解启用事务
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

2. 事务方法未通过代理调用 #

Spring的@Transactional基于AOP代理实现，同一类内部调用事务方法不会触发代理，事务不会生效。确保createMultiDocument方法是被其他Bean调用，而非当前类内部方法调用。

3. 自定义save方法未绑定事务会话 #

代码中template.save1(doc1)、template.save2(doc2)疑似笔误，若为自定义save方法，需确保方法内部使用的Mongo操作绑定了当前事务的会话。标准做法是直接使用MongoTemplate的内置save方法：

@Transactional
public void createMultiDocument() {
  boolean flag = true;
  template.save(doc1);
  template.save(doc2);
  if(flag) {
     throw new RuntimeException();
  }
  template.save(doc3);  
}

若必须自定义save方法，需在方法中通过MongoTemplate.execute绑定会话：

public <T> T save1(T entity) {
    return template.execute(session -> {
        // 基于当前事务会话执行保存操作
        return session.save(entity);
    });
}

4. 检查MongoClient连接配置 #

确认MongoDB连接URI正确配置了副本集信息（Atlas提供的URI默认包含），且MongoClientSettings未禁用事务。无需额外配置事务开关，默认支持，但需确保连接的是副本集（Atlas M3满足）而非单节点实例。

5. 异常被内部捕获 #

确保RuntimeException未被方法内部的try-catch块捕获，必须抛出到Spring事务切面才能触发回滚。

验证步骤 #

1. 启动应用时查看日志，确认MongoTransactionManager已成功初始化。
2. 调用事务方法时，查看MongoDB Atlas的事务日志，确认事务已开启。
3. 抛出异常后，检查数据库数据是否回滚。

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