Java 自定义注解中怎么通过注解定义系统重试策略(Retryable)实现自动容灾

冷漠man

冷漠man

2026-07-29

662人浏览

原创

可以自定义注解+ aop 实现轻量级重试功能:定义含 maxattempts、delay、multiplier、retryableexceptions 和 ignoreexceptions 参数的 @retryable 注解,并通过切面拦截执行重试逻辑。

java 自定义注解中怎么通过注解定义系统重试策略(retryable)实现自动容灾

Java 中可以通过自定义注解 + AOP(切面)的方式,实现类似 Spring Retry 的 @Retryable 功能,让系统在方法失败时自动重试,达到轻量级容灾效果。核心思路是:定义注解声明重试规则 → 编写切面拦截带注解的方法 → 在切面中按策略执行重试逻辑。

定义可配置的重试注解

先创建一个自定义注解,支持常见重试参数:

  • maxAttempts:最大重试次数(含首次调用)
  • delay:首次失败后延迟毫秒数(固定等待)
  • multiplier:退避倍率(用于指数退避,如 2.0 表示每次延迟翻倍)
  • retryableExceptions:哪些异常触发重试(白名单)
  • ignoreExceptions:哪些异常直接抛出、不重试(黑名单)

示例定义:

@Target({ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
public @interface Retryable {
    int maxAttempts() default 3;
    long delay() default 1000;
    double multiplier() default 1.0;
    Class extends Throwable>[] retryableExceptions() default {Exception.class};
    Class extends Throwable>[] ignoreExceptions() default {};
}

编写切面实现重试逻辑

使用 @Around 拦截标注了 @Retryable 的方法,手动控制执行与重试流程:

  • 获取注解配置,初始化当前延迟时间(currentDelay = delay
  • 循环执行方法(最多 maxAttempts 次),每次捕获异常
  • 若抛出的异常属于 ignoreExceptions,立即抛出不重试
  • 若属于 retryableExceptions 且未达最大次数,则休眠 currentDelay 后重试,并更新延迟(如乘以 multiplier)
  • 若成功或重试耗尽,返回结果或最终异常

注意:需用 Thread.sleep() 或更优的 ScheduledExecutorService 控制延迟,避免阻塞主线程(尤其在 Web 场景下需谨慎)。

Java Linux版
Java Linux版

Java Linux版下载入口,提供 Oracle JDK 26.0.2 官方 Linux 安装包、Java 环境配置、JDBC 数据库连接和 Java 服务端开发相关信息。

下载

注册切面并启用代理

确保切面被 Spring 扫描到,并开启 AspectJ 代理:

  • 切面类加上 @Aspect@Component
  • 主配置类或启动类添加 @EnableAspectJAutoProxy
  • 确保目标方法是 Spring 管理的 Bean(非 this. 调用),否则 AOP 不生效

简单切面骨架示例:

@Aspect
@Component
public class RetryAspect {
    @Around("@annotation(retryable)")
    public Object doRetry(ProceedingJoinPoint joinPoint, Retryable retryable) throws Throwable {
        // 实现上述重试逻辑
        return ...;
    }
}

增强健壮性的小技巧

生产环境建议补充以下细节:

  • 记录每次重试日志(如“第 2 次重试,延迟 2000ms”),便于问题追踪
  • 支持异步重试(用 CompletableFuture 或线程池),避免阻塞调用方
  • 加入熔断判断(如连续 N 次失败后暂时跳过重试),防止雪崩
  • 允许通过 SpEL 表达式动态计算参数(如 delay = "#{@config.retryDelay}"),提升灵活性

不复杂但容易忽略:重试只对**幂等操作**安全,务必确认被重试方法具备幂等性(如查询、带唯一键的插入、状态机推进等),否则可能引发数据重复或不一致。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

3768

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

2796

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

2802

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

637

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

602

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

705

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1290

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

18844

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

646

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

Java 26官方文档
Java 26官方文档

共0课时 | 0人学习