作者:京东物流 孔祥东
背景
事情是这样,最近在实现一个需求的时候,有一个定时异步任务会捞取主表的数据并置为处理中(为了防止任务执行时间过长,下次任务执行把本次数据重复捞取),然后根据主表关联明细表数据,然后将明细表数据进行组装,等待所有明细数据处理完成之后,将主表状态置为完成;大概当时的代码示例(只是截取部分)如下:
@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 |
多线程调用 | 方法在不同线程中,数据库链接有可能不是一个,从而是两个不同事务 |