Transaction rolled back because it has been marked as rollback-only

Transaction rolled back because it has been marked as rollback-only

问题

程序运行报异常 org.springframework.transaction.UnexpectedRollbackException: Transaction rolled back because it has been marked as rollback-only，错误日志堆栈找不出明显痕迹。

场景还原

入口：

@Transactional
public void saveUserList(List<User> userList) {
  User user = new User("100", "杭州", "张三");
  serviceWarp.saveUser(user);
  try {
    serviceWarp.saveUserList(userList);
  } catch (Exception e) {
    log.error("啥也不干");
  }
}

内部调用：

public void saveUser(User user) {
  userMapper.saveUser(user);
}

@Transactional
public void saveUserList(List<User> userList) {
  for (User user : userList) {
    userMapper.saveUser(user); // 数据库中造好数据，让它抛出主键冲突异常
  }
}

原因

spring 事务管理，启用事务的方法，调用另一个事务方法时，会进行事务传播。注解@Transactional默认的传播机制是PROPAGATION_REQUIRED。

传播行为	含义
PROPAGATION_REQUIRED	表示当前方法必须运行在事务中。如果当前事务存在，方法将会在该事务中运行。否则，会启动一个新的事务

所以是补齐方法运行的时候，同步的事务合并到了补齐的事务里面。当同步发票发生异常后，被try catch 捕获，没有抛出来。但是事务还是会进行回滚，回滚执行到 DataSourceTransactionManager 类的 doSetRollbackOnly 方法时，设置了rollbackOnly = true;

public void setRollbackOnly() {
  this.getConnectionHolder().setRollbackOnly();
}

public void setRollbackOnly() {
  this.rollbackOnly = true;
}

​ 由于异常被catch, 不阻断整个事务执行。整个事务执行完后，执行commit 提交，执行到 DefaultTransactionStatus 类的 isGlobalRollbackOnly方法时，判断rollbackOnly 为true, 则执行回滚，并且打出那句报错的日志”Transaction rolled back because it has been marked as rollback-only”。

if (!shouldCommitOnGlobalRollbackOnly() && defStatus.isGlobalRollbackOnly()) {
  if (defStatus.isDebug()) {
    logger.debug("Global transaction is marked as rollback-only but transactional code requested commit");
  }
  processRollback(defStatus);
  // Throw UnexpectedRollbackException only at outermost transaction boundary
  // or if explicitly asked to.
  if (status.isNewTransaction() || isFailEarlyOnGlobalRollbackOnly()) {
    throw new UnexpectedRollbackException(
      "Transaction rolled back because it has been marked as rollback-only");
}

@Override
public boolean isGlobalRollbackOnly() {
  return ((this.transaction instanceof SmartTransactionObject) &&
          ((SmartTransactionObject) this.transaction).isRollbackOnly());
}

一些思考

1. 一个事务能完成就一个事务
2. 事务嵌套传播的时候，少用try catch, 该回滚就回滚
3. 事务嵌套传播的时候, 可以指定传播方式，根据需求可以将内部事务指定为@Transactional(propagation = Propagation.NESTED) 或 @Transactional(propagation = Propagation.PROPAGATION_REQUIRED_NEW)

传播行为	含义
PROPAGATION_REQUIRED_NEW	表示当前方法必须运行在它自己的事务中。一个新的事务将被启动。如果存在当前事务，在该方法执行期间，当前事务会被挂起。
PROPAGATION_NESTED	表示如果当前已经存在一个事务，那么该方法将会在嵌套事务中运行。嵌套的事务可以独立于当前事务进行单独地提交或回滚。如果当前事务不存在，那么其行为与PROPAGATION_REQUIRED一样。注意各厂商对这种传播行为的支持是有所差异的。可以参考资源管理器的文档来确认它们是否支持嵌套事务