核心是通过@idempotent注解与aop拦截器结合redis实现幂等：方法执行前用业务唯一标识（如接口路径+请求体sha256摘要）尝试setifabsent写入redis，成功则放行，失败则拒绝重复请求，避免重复处理。
Java中用自定义注解 @Idempotent 结合 Redis 实现接口幂等性，核心是：在方法执行前，通过唯一业务标识（如请求ID或参数摘要）尝试写入Redis，成功则继续执行，失败（已存在）则直接返回，避免重复处理。
定义@Idempotent注解
声明一个运行时保留、可作用于方法的注解，支持配置过期时间与key生成策略：
- 用
@Target(ElementType.METHOD)标明只能加在方法上 - 用
@Retention(RetentionPolicy.RUNTIME)确保能被AOP读取 - 添加
expire()属性，默认30秒，适配多数短时业务场景 - 可选
keyGenerator()指定Key生成器类，便于扩展不同参数组合逻辑
编写AOP切面拦截逻辑
使用 @Aspect 和 @Around 拦截带 @Idempotent 的方法，关键步骤如下：
Java JDK 25
下载
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
- 解析注解参数，获取过期时间和Key生成器
- 调用
keyGenerator.generate(joinPoint)得到唯一key（例如：MD5(类名+方法名+JSON参数)） - 执行
redisTemplate.opsForValue().setIfAbsent(key, "1", expire, TimeUnit.SECONDS) - 若返回
true，放行执行原方法；若为false，抛出IdempotentException或直接返回预设结果（如{"code":200,"msg":"请求已处理"}）
注意Redis key的唯一性与安全性
Key设计直接影响幂等效果，需兼顾业务语义和防碰撞：
- 避免仅用用户ID或订单号——同一用户多次提交不同数据应视为不同请求
- 推荐组合：接口路径 + 请求体摘要（如Jackson序列化后SHA256），或前端传入的
idempotentId请求头 - 敏感字段（如密码、token）需在摘要前剔除，防止Redis里泄露
- 若用Lua脚本原子写入+设置过期，可规避SETNX+EXPIRE的竞态问题（Redis 2.6.12+ 支持
SET key value EX seconds NX）
补充异常处理与日志
幂等校验失败不是系统错误，应区分对待：
- 捕获
IdempotentException并统一返回HTTP 200 + 业务码（如"idempotent_rejected"），不记ERROR日志 - 记录INFO级日志："[Idempotent] Reject duplicate request: {key}"，便于审计与排查误重试
- 测试时模拟重复请求（相同Header/Body），验证是否真跳过业务逻辑（如数据库INSERT未发生两次）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
