Java Spring环境下RetryTemplate.execute未被调用问题排查

一、现有代码的核心错误点 #

• XML Bean配置完全失配
  • 定义retryTemplateBean时，错误将class属性写为com.checkUser，实际Spring Retry的RetryTemplate类全限定名为org.springframework.retry.support.RetryTemplate，当前配置等于把普通业务类实例当成重试模板注册，类型完全不匹配。
  • 给checkUser注入构造参数时，参数索引写错：自定义的有参构造器仅含1个RetryTemplate类型参数，对应索引为0，但配置中写了index="1"，Spring无法匹配到对应参数，会默认走无参构造器初始化checkUser，此时类内retryTemplate成员变量为null。
  • 构造参数传值方式错误：配置中使用value="${retryTemplate}"引用属性占位符，而非Spring容器的Bean引用，既无法获取目标RetryTemplate实例，还可能因占位符解析失败导致容器启动失败。
• 业务代码逻辑冲突
  • 重复覆盖注入实例：在checkGroup()方法第一行直接执行retryTemplate = retryConfig()，不管Spring容器注入的是什么实例，都会被替换为方法内new出来的新对象，完全失去Spring容器统一管理Bean的意义。
  • 重试判断和最大尝试次数不匹配：配置的SimpleRetryPolicy设置maxAttempts=2，代表业务方法最多总共执行2次；但代码中判断retryContext.getRetryCount() <2时就抛异常，第一次执行retryCount=0抛异常，第二次执行retryCount=1仍抛异常，刚达到最大尝试次数就直接抛出异常，会给人“execute块根本没触发业务”的错觉。
  • 方法访问权限不合理：checkGroup()被定义为private，外部Bean无法直接调用该方法，容易出现测试时调用不到逻辑的问题。

二、修正后的正确实现 #

1. 修正后的XML Bean配置 #

<!-- 注册正确的RetryTemplate Bean -->
<bean id="retryTemplate" class="org.springframework.retry.support.RetryTemplate">
    <!-- 配置固定退避策略 -->
    <property name="backOffPolicy">
        <bean class="org.springframework.retry.backoff.FixedBackOffPolicy">
            <property name="backOffPeriod" value="2000"/>
        </bean>
    </property>
    <!-- 配置简单重试策略，设置最大尝试次数为3 -->
    <property name="retryPolicy">
        <bean class="org.springframework.retry.policy.SimpleRetryPolicy">
            <property name="maxAttempts" value="3"/>
        </bean>
    </property>
</bean>

<!-- 正确配置checkUser Bean的构造注入 -->
<bean id="checkUser" class="com.CheckUser">
    <!-- 匹配有参构造器的索引0参数，通过ref引用容器内的retryTemplate实例 -->
    <constructor-arg index="0" ref="retryTemplate"/>
</bean>

2. 修正后的业务代码 #

// 遵循Java类名大驼峰命名规范
public class CheckUser { 
    // 由Spring容器注入的重试模板实例，不重复初始化
    private RetryTemplate retryTemplate;

    public CheckUser(){}

    public CheckUser(RetryTemplate retryTemplate){
        this.retryTemplate = retryTemplate;
    }
 
    // 删除原retryConfig()方法，RetryTemplate的配置完全交给Spring容器统一管理

    // 调整为public权限，允许外部Bean正常调用
    public void checkGroup() throws Exception {
        try {
            retryTemplate.execute(new RetryCallback<Object, Exception>() {
                @Override
                public Object doWithRetry(RetryContext retryContext) throws Exception {
                    // 调整判断逻辑：前2次执行模拟异常触发重试，达到最大次数后执行正常业务
                    if (retryContext.getRetryCount() < 2) {
                        throw new RuntimeException("模拟业务异常触发重试");
                    }
                    // 重试通过后执行核心业务逻辑
                    // do something
                    return null;
                }
            });
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

三、常见排查补充 #

• 确认项目已引入spring-retry核心依赖，避免类加载缺失导致RetryTemplate初始化失败
• 确保调用checkGroup()的对象是从Spring容器获取的Bean实例，而非手动new的普通Java对象，否则构造器注入的retryTemplate为null，会直接抛出空指针，无法进入execute方法块
• 检查异常匹配规则：SimpleRetryPolicy默认仅对Exception类型异常触发重试，如果业务抛出的是Error类型错误，不会进入重试流程

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