AWS DocumentDB集成Spring Boot时@Transactional不生效问题

可能的原因与修复步骤 #

1. 缺少事务管理启用注解 #

Spring Boot不会自动启用事务管理机制，必须在配置类或启动类上添加@EnableTransactionManagement，才能让Spring识别@Transactional注解并生成事务代理。

修改配置类：

@Configuration
@EnableTransactionManagement // 新增此注解
public class DocumentDBConfig {

    @Bean
    MongoTransactionManager transactionManager(MongoDatabaseFactory db) {
        TransactionOptions txnOptions = TransactionOptions.builder()
                .readPreference(ReadPreference.primary())
                .readConcern(ReadConcern.SNAPSHOT) // 事务要求使用快照隔离级别
                .writeConcern(WriteConcern.MAJORITY)
                .build();
        return new MongoTransactionManager(db, txnOptions);
    }
}

2. URI参数retryWrites=false阻断事务正常流程 #

AWS DocumentDB的事务依赖retryWrites=true配置，你的URI中设置为false会破坏事务的重试与回滚机制，导致事务无法正确触发回滚。

更新MongoDB URI：

hostname:27017/test?ssl=true&retryWrites=true&replicaSet=rs0&readPreference=secondaryPreferred

3. ReadConcern配置不符合事务要求 #

MongoDB（含DocumentDB）的事务必须使用ReadConcern.SNAPSHOT保证事务内的数据一致性，你当前配置的ReadConcern.LOCAL不支持事务级别的快照隔离，会导致事务行为异常。

4. 确认DocumentDB集群的写关注能力 #

确保你的DocumentDB集群满足WriteConcern.MAJORITY的要求：

• 集群至少包含3个节点（DocumentDB默认是3节点多AZ部署）
• 单节点集群无法达成MAJORITY共识，会导致写入超时或事务逻辑失效

5. 验证Repository的代理有效性 #

确保PersonRepository是继承MongoRepository的接口，且处于Spring自动扫描的包路径下（或添加@Repository注解），这样Spring才能为其生成事务代理，保证save操作在事务上下文内执行。

验证方法 #

修改配置后重新测试：

1. 调用add()方法触发ArithmeticException
2. 检查数据库确认personOne未被持久化

若问题仍存在，可开启Spring事务与MongoDB的调试日志，查看事务创建、提交、回滚的详细流程：

logging.level.org.springframework.data.mongodb.core.MongoTransactionManager=DEBUG
logging.level.org.springframework.transaction=DEBUG

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