如何基于配置开关控制@Transactional注解是否生效

方案1：全局条件化配置（无业务代码侵入，优先推荐） #

核心逻辑是通过配置开关控制事务管理器和事务注解扫描的注册，开关关闭时Spring不会识别@Transactional注解，自然不会触发报错。
步骤：

1. 新增条件化事务配置类，移除原有代码里的@EnableTransactionManagement注解，迁移到这个配置类中：

import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.MongoDatabaseFactory;
import org.springframework.data.mongodb.transaction.MongoTransactionManager;
import org.springframework.transaction.annotation.EnableTransactionManagement;

@Configuration
@ConditionalOnProperty(name = "app.transaction.enabled", havingValue = "true", matchIfMissing = false)
@EnableTransactionManagement
public class MongoTransactionConfig {

    @Bean
    public MongoTransactionManager transactionManager(MongoDatabaseFactory dbFactory) {
        return new MongoTransactionManager(dbFactory);
    }
}

2. 在配置文件中添加开关配置：

• MongoDB场景配置：app.transaction.enabled=true，此时@Transactional注解完全正常生效
• CosmosDB场景配置：app.transaction.enabled=false，此时事务相关配置完全不加载，@Transactional注解会被Spring忽略，不会触发报错
  适用场景：所有标注@Transactional的方法都需要统一开关控制的场景，不需要修改任何业务代码。

方案2：自定义AOP切面（细粒度控制，适合部分方法需要区分的场景） #

如果需要针对部分方法做事务开关控制，或者项目中存在其他需要事务的数据源，可以用自定义切面实现开关逻辑：

1. 定义自定义条件事务注解：

import org.springframework.transaction.TransactionDefinition;
import org.springframework.transaction.annotation.Isolation;
import org.springframework.transaction.annotation.Propagation;
import java.lang.annotation.*;

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
public @interface ConditionalTransactional {
    Class<? extends Throwable>[] rollbackFor() default {};
    Propagation propagation() default Propagation.REQUIRED;
    Isolation isolation() default Isolation.DEFAULT;
    int timeout() default TransactionDefinition.TIMEOUT_DEFAULT;
    boolean readOnly() default false;
}

2. 实现事务开关切面：

import org.aspectj.lang.ProceedingJoinPoint;
import org.aspectj.lang.annotation.Around;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;
import org.springframework.transaction.interceptor.TransactionInterceptor;

@Aspect
@Component
public class ConditionalTransactionAspect {

    @Value("${app.transaction.enabled:false}")
    private boolean transactionEnabled;

    private final TransactionInterceptor transactionInterceptor;

    public ConditionalTransactionAspect(TransactionInterceptor transactionInterceptor) {
        this.transactionInterceptor = transactionInterceptor;
    }

    @Around("@annotation(conditionalTransactional)")
    public Object around(ProceedingJoinPoint pjp, ConditionalTransactional conditionalTransactional) throws Throwable {
        // 开关关闭时直接执行业务逻辑，不开启事务
        if (!transactionEnabled) {
            return pjp.proceed();
        }
        // 开关开启时调用Spring原生事务逻辑处理
        return transactionInterceptor.invoke(invocation -> pjp.proceed());
    }
}

3. 把业务代码中原有的@Transactional替换为@ConditionalTransactional即可，开关配置逻辑和方案1一致。

注意事项 #

• 方案1无业务代码侵入，实现成本最低，是同套代码二选一数据库场景的最优解
• 方案2适合多数据源并存，仅部分MongoDB业务方法需要事务控制的场景

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