@Transaction注解的失效场景

作者：京东物流 孔祥东

背景

事情是这样，最近在实现一个需求的时候，有一个定时异步任务会捞取主表的数据并置为处理中（为了防止任务执行时间过长，下次任务执行把本次数据重复捞取），然后根据主表关联明细表数据，然后将明细表数据进行组装，等待所有明细数据处理完成之后，将主表状态置为完成；大概当时的代码示例（只是截取部分）如下：

    @Override
	@Transactional
    protected void executeTasks(List<AbnormalHotspot> list) {
        CallerInfo infoJk = Profiler.registerInfo("com.jd.xxxxx.executeTasks", "qc-xxxxxx",false, true);

        try{
            //更新主表的状态为中间态
            hotSpotService.updateAbnormalHotspotStatus(list, HotSpotStatusEnum.EXECUTING.getCode());

			//处理明细表数据
            for(AbnormalHotspot hotspot : list){

                //组装批次基本信息
                AbnormalHotSpotSendToMcssMq spotSendToMcssMq = assemblyAbnormalHotSpotSendToMcssMqFromMain(hotspot);

                //组装附件信息，此处存在抛出IOException 异常的可能
                List<HotSpotAttachmentBo> attachmentBos = assemblyAttachment(hotspot.getBusinessCode());
                spotSendToMcssMq.setAttachmentAddr(JSON.toJSONString(attachmentBos));

            }
            //更新主表的状态为终态
            hotSpotService.updateAbnormalHotspotStatus(list, HotSpotStatusEnum.FINISHED.getCode());

        }finally {
            Profiler.registerInfoEnd(infoJk);
        }

然后执行测试的时候发现，代码抛出异常了，可主表数据的状态一直是处理中，并没有发生回滚，但是看代码也已经加上@Transaction 注解了，所以就怀疑是不是事务没有生效，带着这个问题就顺便重新复习了一下@Transaction 注解的使用以及事务相关的一些知识。

过程

首先带着刚刚的问题，来看看Spring 的源码。

/**  @Transaction 注解中的这个方法定义，可以指定回滚的异常类型，
        可以指定0-多个exception 子类
	 * Defines zero (0) or more exception {@link Class classes}, which must be a
	 * subclass of {@link Throwable}, indicating which exception types must cause
	 * a transaction rollback.
	 * <p>This is the preferred way to construct a rollback rule, matching the
	 * exception class and subclasses.
	 * <p>Similar to {@link org.springframework.transaction.interceptor.RollbackRuleAttribute#RollbackRuleAttribute(Class clazz)}
	 */

	Class<? extends Throwable>[] rollbackFor() default {}

接着再看

org.springframework.transaction.interceptor.RollbackRuleAttribute类中有一个方法是在匹配查找异常。

/**
	 * 递归查询匹配的异常类
      * Return the depth of the superclass matching.
	 * <p>{@code 0} means {@code ex} matches exactly. Returns
	 * {@code -1} if there is no match. Otherwise, returns depth with the
	 * lowest depth winning.
	 */
	public int getDepth(Throwable ex) {
		return getDepth(ex.getClass(), 0);
	}

	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.equals(Throwable.class)) {
			return -1;
		}
		return getDepth(exceptionClass.getSuperclass(), depth + 1);
	}

这时候再看这个getDepth 方法的调用的地方是这个

org.springframework.transaction.interceptor.RuleBasedTransactionAttribute 类，这个类中就会出现一个rollbackOn 的方法，但是这个方法并不是它自身的，而且重写了它的父类org.springframework.transaction.interceptor.DefaultTransactionAttribute，所以我们需要看的是这个默认的实物属性类的描述。

/**  默认的回滚行为 unchecked exception，并且ERROR 也会回滚
	 * The default behavior is as with EJB: rollback on unchecked exception.
	 * Additionally attempt to rollback on Error.
	 * <p>This is consistent with TransactionTemplate's default behavior.
	 */
	public boolean rollbackOn(Throwable ex) {
		return (ex instanceof RuntimeException || ex instanceof Error);
	}

到这里我们应该就可以知道上述问题的缘故了。

结论

@Transaction 如果不显示声明回滚的异常类型的话，默认只会回滚RuntimeException 异常（运行时异常）及其子类以及Error 及其子类，由此也可以得出，如果事务方法中的异常被catch 了，也会使事务失效。

扩展总结

到这里，你以为就完了吗！这就一点不符合我们的程序员的发型了！！！！

下面，我们就来看一下@Transaction 里面是什么东西

@Target({ElementType.METHOD, ElementType.TYPE})
@Retention(RetentionPolicy.RUNTIME)
@Inherited
@Documented
public @interface Transactional {

    @AliasFor("transactionManager")
    String value() default "";
    //事务管理器名称
    @AliasFor("value")
    String transactionManager() default "";
    //事务传播模式
    Propagation propagation() default Propagation.REQUIRED;
    //事务隔离级别
    Isolation isolation() default Isolation.DEFAULT;
    //超时时间
    int timeout() default TransactionDefinition.TIMEOUT_DEFAULT;
    //是否是只读事务
    boolean readOnly() default false;
    //需要回滚的异常类
    Class<? extends Throwable>[] rollbackFor() default {};
    //需要回滚的异常类名称
    String[] rollbackForClassName() default {};
    //排除回滚的异常类
    Class<? extends Throwable>[] noRollbackFor() default {};
    //排除回滚的异常类名称
    String[] noRollbackForClassName() default {};
}

value,transactionManager 方法都是设置事务管理器的，不太需要关注

propagation 事务传播行为

为了解决业务层方法之间互相调用的事务问题。

当事务方法被另一个事务方法调用时，必须指定事务应该如何传播。例如：方法可能继续在现有事务中运行，也可能开启一个新事务，并在自己的事务中运行。在TransactionDefinition定义中包括了如下几个表示传播行为的常量：

public enum Propagation {

	//默认值
	//当前有事务，就加入这个事务，没有事务，就新建一个事务（也就是说如果A方法和B方法都添加了注解，默认传播模式下，A方法调用B方法，会将两个方法事务合并为一个）
	REQUIRED(TransactionDefinition.PROPAGATION_REQUIRED),

  	//当前有事务，就加入这个事务，没有事务，就以非事务的方式执行
	SUPPORTS(TransactionDefinition.PROPAGATION_SUPPORTS),

	//当前有事务，就加入这个事务，没有事务，就抛出异常
	MANDATORY(TransactionDefinition.PROPAGATION_MANDATORY),

	//新建一个事务执行，如果当前有事务，就把当前的事务挂起（如果A方法默认为Propagation.REQUIRED模式，B方法为Propagation.REQUIRES_NEW，在A方法中调用B方法，A方法抛出异常后，B方法不会回滚，因为Propagation.REQUIRES_NEW会暂停A方法的事务）
	REQUIRES_NEW(TransactionDefinition.PROPAGATION_REQUIRES_NEW),

	//在无事务状态下执行，如果当前有事务，就把当前的事务挂起
	NOT_SUPPORTED(TransactionDefinition.PROPAGATION_NOT_SUPPORTED),

	//在无事务状态下执行，如果当前有事务，会抛出异常
	NEVER(TransactionDefinition.PROPAGATION_NEVER),

	 //当前有事务，就新建一个事务，嵌套执行，当前无事务，就新建一个事务执行（Spring 特有的）
	NESTED(TransactionDefinition.PROPAGATION_NESTE

看到这里就会发现，如果事务传播行为设置不当的话，也会使事务失效。

从上述来看，配置错误这三种

TransactionDefinition.PROPAGATION_SUPPORTS，TransactionDefinition.PROPAGATION_NOT_SUPPORTED，TransactionDefinition.PROPAGATION_NEVER都有可能会出现失效。

isolation 方法

定义了一个事务可能受其他并发事务影响的程度，带来的是脏读，丢失修改，不可重复读，幻读等问题，所以不会是事务失效，这部分内容还可以进一步研究。

timeout

定义的是事务的最长执行时间，如果超过该时间限制但事务还没有完成，则自动回滚事务，也不会使事务失效。

readOnly:

事务的只读属性是指，对事务性资源进行只读操作或者是读写操作.

rollbackfor,rollbackforClassName,norollbackfor,rollbackforClassName

都是显示声明哪些异常类需要回滚或者不需要回滚，这个在上述已经回答过了。

看到这里，是不是以为失效的场景就这些了呢，No

再进一步想想，Spring 事务是基于什么实现的？是不是每个程序员在学习AOP 的时候都会听到AOP 的应用场景，如日志，事务，权限等等。

所以想想，既然Spring 事务是基于AOP 实现的，那可以想想如果事务方法要是没有被Spring 代理对象来调用的话，是不是就加不上事务了，打个比方，如下代码：

class TransactionTest{
    public void A() throws Exception {
        this.B();
        ... ...
    }

    @Transactional()
    public void B() throws Exception {
          //数据源操作
    }
}

方法B 的事务会生效吗？答案是不会，因为this 是指当前实例，并不是Spring 代理的，所以B 方法的事务肯定是加不上的，由此可以得出，在同一个类中方法调用也会使事务失效。

其实上述提到的事务时效只是基于自己的遇到的问题来分析，对于Spring 事务时效的场景应该来说还有很多很多，下面大概整理一下常见的吧。

失效场景	备注
未加入Spring容器管理	类未标注@Service、@Component等注解，或者Spring扫描路径不对
表不支持	mysql5 之前数据库引擎默认是myisam ,它是不支持事务的
catch 异常	将增删改方法catch了
自定义回滚异常	默认只能回滚RuntimeException 异常，如果自定义了一个回滚异常，但是实际抛出的异常又不是声明的自定义的，就会时效
抛出了自定义异常	默认只能回滚RuntimeException 异常，如果自定义了一个抛出异常，又没有在注解中显示声明对应回滚异常
错误的传播特性	上述已讲解
方法内部调用	一个类里面的方法，相互调用
方法使用final 修改	方法使用final 修饰
方法访问权限不对	方法声明成private
多线程调用	方法在不同线程中，数据库链接有可能不是一个，从而是两个不同事务