Spring Batch步骤失败时Exit Message为JPA回滚异常而非自定义RuntimeException问题

你遇到的异常覆盖问题本质是长事务导致的数据库连接失效：

• Spring Batch默认Tasklet步骤运行时会开启事务，你的轮询逻辑最长执行100分钟，对应事务也会持续持有数据库连接长达100分钟，远远超出了数据库、连接池默认的连接超时时间，连接早就被服务端回收或者断开了。
• 当pollForFile()抛出自定义RuntimeException触发步骤失败时，Spring Batch会尝试回滚步骤关联的JPA事务，此时检测到数据库连接已经不可用，回滚操作本身抛出了TransactionSystemException。这个回滚异常晚于你自定义的异常抛出，会覆盖原异常作为步骤最终的失败原因写入STEP EXECUTION表的EXIT MESSAGE字段。

推荐按优先级选择以下方案：

方案1：禁用轮询步骤的事务（最优） #

轮询远程文件的逻辑本身不需要操作业务数据库，完全没有必要开启事务，直接配置该步骤不启动事务即可从根源避免回滚异常：

@Bean
@Qualifier("pollStep")
public Step pollStep() {
    // 自定义事务属性，设置传播级别为NOT_SUPPORTED，即当前步骤不运行在事务中
    DefaultTransactionAttribute noTxAttribute = new DefaultTransactionAttribute();
    noTxAttribute.setPropagationBehavior(TransactionAttribute.PROPAGATION_NOT_SUPPORTED);

    return stepBuilderFactory.get("pollStep")
            .tasklet(filePollingTasklet())
            .transactionAttribute(noTxAttribute)
            .listener(promoteContextListener())
            .build();
}

配置后步骤不会持有数据库连接，抛出自定义异常后也无需回滚事务，原异常信息会正常写入EXIT MESSAGE。

方案2：手动指定步骤失败的Exit描述 #

如果因为特殊原因需要保留步骤事务，可以添加StepExecutionListener手动捕获原始自定义异常，覆盖默认的Exit信息：

public class CustomPollStepListener implements StepExecutionListener {
    @Override
    public ExitStatus afterStep(StepExecution stepExecution) {
        // 遍历所有失败异常，优先取自定义的文件未找到异常
        for (Throwable ex : stepExecution.getFailureExceptions()) {
            // 替换为你自定义异常的判断逻辑，比如类型判断、关键字匹配
            if (ex.getMessage() != null && ex.getMessage().contains("轮询未找到目标文件")) {
                return ExitStatus.FAILED.addExitDescription(ex);
            }
        }
        return stepExecution.getExitStatus();
    }
}

将该监听器添加到pollStep的监听器列表中即可。

方案3：调整事务超时时间（不推荐） #

如果必须保留步骤事务，可调整连接池、数据库的连接超时时间、Spring事务超时时间到大于100分钟，避免连接提前失效。但长事务会长期占用数据库连接资源，容易引发数据库性能问题，仅作为临时方案使用。

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