Spring6集成Resilience4j时Fallback方法匹配失败问题

• 严格匹配参数签名与顺序
  Spring6对Fallback方法的参数匹配逻辑更严谨，要求Fallback方法必须包含原方法的全部参数，再在末尾追加Throwable类型的异常参数。比如原方法是getUser(String userId)，Fallback方法必须写成getDefaultUser(String userId, Throwable ex)，参数顺序不能颠倒，异常类型必须是Throwable（不能用Exception等子类，否则反射匹配会失败）。

• 核对Fallback注解配置
  检查熔断注解（如@CircuitBreaker、@Fallback）中指定的fallbackMethod名称是否和实际方法名完全一致，注意大小写敏感，避免拼写错误。

• 确保方法访问权限
  Fallback方法必须设置为public修饰符，Spring6的FallbackExecutor需要通过反射访问该方法，private/protected修饰符会导致无法识别。

• 适配第三方库版本
  如果使用Resilience4j等第三方熔断组件，必须升级到兼容Spring6的版本（如Resilience4j 1.7.0及以上），旧版本的Fallback匹配逻辑可能不兼容Spring6的反射规则。同时排查依赖冲突，避免引入旧版本的Spring相关熔断依赖。

• 示例正确的Fallback方法签名

  public class UserDataResolver {
      // 原业务方法
      public User getUser(String userId) {
          // 业务逻辑
      }
  
      // 正确的Fallback方法
      public User getDefaultUser(String userId, Throwable throwable) {
          return new User("default", "默认用户");
      }
  }
  

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