StoredProcedureItemReader遇SQLTimeoutException无法重试问题排查

问题根本原因 #

1. 重试逻辑覆盖范围不全：你自定义的RetryableItemReader仅将read()方法纳入了RetryTemplate的执行范围，而你遇到的异常发生在StoredProcedureItemReader的open()生命周期阶段（游标初始化、存储过程调用的建联逻辑都在该方法内执行），这部分逻辑完全没有被重试逻辑包裹，自然无法触发重试。
2. 步骤级重试不覆盖Reader生命周期：你在Step配置中声明的faultTolerant重试规则，仅作用于Chunk的读取-处理-写入执行流程，Spring Batch的ItemStream接口的生命周期方法（open、update、close）不属于Chunk处理逻辑的一部分，因此这部分抛出的异常不会触发步骤级重试。

修复方案 #

改造RetryableItemReader的open方法，将初始化逻辑纳入重试 #

修改自定义RetryableItemReader的open方法，把委托Reader的初始化逻辑包裹在RetryTemplate中执行，同时每次重试前清理上一次失败残留的资源避免连接泄漏：

@Override
public void open(ExecutionContext executionContext) throws ItemStreamException {
    try {
        retryTemplate.execute(context -> {
            // 清理上一次重试的残留资源
            delegate.close();
            delegate.open(executionContext);
            return null;
        });
    } catch (Exception e) {
        throw new ItemStreamException("读取器重试初始化后仍然失败", e);
    }
}

其他优化建议 #

• 避免重试规则重复：你当前同时配置了步骤级重试和Reader内部重试，容易出现重试次数叠加的问题，建议保留一套重试逻辑即可，优先选择Reader内部重试（重启成本更低）。
• 校验异常匹配规则：部分数据库驱动会将SQLTimeoutException包装为Spring的DataAccessException子类抛出，建议打印异常的完整类型链，确保你配置的重试异常类型可以正确匹配。
• 注意资源泄漏：重试逻辑中一定要补充资源清理的步骤，避免多次重试导致数据库连接耗尽。

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