@Transactional注解为何会失效

news2024/12/26 9:32:15

使用 @Transactional 注解能保证方法内多个数据库操作要么同时成功、要么同时失败。但是有很多细节需要注意，不然@Transactional可能会失效。

1.注解应用在非 public 的方法上

如果Transactional注解应用在非public 修饰的方法上，Transactional将会失效。

因为在Spring AOP 代理时， TransactionInterceptor（事务拦截器）在目标方法执行前后进行拦截，DynamicAdvisedInterceptor（CglibAopProxy 的内部类）的 intercept 方法或 JdkDynamicAopProxy 的 invoke 方法会间接调用 AbstractFallbackTransactionAttributeSource的 computeTransactionAttribute 方法，获取Transactional 注解的事务配置信息。

protected TransactionAttribute computeTransactionAttribute(Method method, Class<?> targetClass) {
    
        // Don't allow no-public methods as required.
        if (allowPublicMethodsOnly() && !Modifier.isPublic(method.getModifiers())) {
            return null;
        }
}

此方法会检查目标方法的修饰符是否为 public，不是 public则不会获取@Transactional 的属性配置信息。

在这里插入图片描述

另外 protected、private 修饰的方法上使用 @Transactional 注解，虽然事务无效，但不会有任何报错，有些编辑器会提醒非 public 的报错。

2.propagation 属性设置错误

这种失效是由于配置错误，若是错误的配置以下三种 propagation，事务将不会发生回滚。

TransactionDefinition.PROPAGATION_SUPPORTS：如果当前存在事务，则加入该事务；如果当前没有事务，则以非事务的方式继续运行。
TransactionDefinition.PROPAGATION_NOT_SUPPORTED：以非事务方式运行，如果当前存在事务，则把当前事务挂起。
TransactionDefinition.PROPAGATION_NEVER：以非事务方式运行，如果当前存在事务，则抛出异常。

3. rollbackFor 设置错误

rollbackFor 可以指定能够触发事务回滚的异常类型。Spring 默认抛出了未检查 unchecked异常（继承自 RuntimeException的异常）或者 Error才回滚事务；其他异常不会触发回滚事务。如果在事务中抛出其他类型的异常，但却期望 Spring 能够回滚事务，就需要指定 rollbackFor 属性。

在这里插入图片描述

若在目标方法中抛出的异常是 rollbackFor 指定的异常的子类，事务同样会回滚。

 private int getDepth(Class<?> exceptionClass, int depth) {

        if (exceptionClass.getName().contains(this.exceptionName)) {
            // Found it!
            return depth;
        }
        // If we've gone as far as we can go and haven't found it...
        if (exceptionClass == Throwable.class) {
            return -1;
        }

        return getDepth(exceptionClass.getSuperclass(), depth + 1);
}

抛出自定义的异常回滚

在这里插入图片描述

4.同一个类中方法调用，导致 @Transactional 失效

比如有一个类，它的一个方法1，调用本类的方法2（不论方法2是用 public 还是 private 修饰），但方法1没有声明注解事务，而2方法有。
则外部调用方法1之后，方法2的事务是不会起作用的。

这是因为使用 Spring AOP 代理造成的，因为只有当事务方法被当前类以外的代码调用时，才会由 Spring 生成的代理对象来管理。

private Integer func1() throws Exception {
    User user = new User();
    this.func2();
    return userMapper.insert(user);
}

@Transactional()
public Integer func2() throws Exception {
    Order order = new order();
    return orderMapper.insert(order);
}

5. 异常已经被 catch

这种是比较常见的一种情况

@Transactional
public void func() throws Exception {
    try {
        // doing
        update(user);
        this.func2()
    } catch (Exception e) {
        e.printStackTrace();
    }
}