在分布式系统中，接口幂等性是确保操作一致性的关键特性。
啥是幂等性
幂等性 指的是在给定的条件下，无论操作执行多少次，其结果都保持不变。在接口设计中，幂等性意味着使用相同的参数多次调用接口，应产生与单次调用相同的效果。
CRUD操作的幂等性分析
-
查询（Read）：通常幂等，但若依赖可变数据，则可能非幂等。
-
创建（Create）：天然幂等，重复创建相同记录应避免或处理。
-
更新（Update）：理论上幂等，但如基于前一状态的增量更新则非幂等。
-
删除（Delete）：天然幂等，重复删除相同记录应直接返回成功。
接口幂等与防抖的区别
-
防抖：防止用户在短时间内重复触发操作，通常用于前端。
-
幂等性：确保后端接口在重复调用时保持一致性。
Demo
定义Idempotent注解
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@Documented
public @interface Idempotent {String key() default "#root.methodName + #root.args";int expireTime() default 60; // 过期时间，默认60秒TimeUnit timeUnit() default TimeUnit.SECONDS;String info() default "操作过于频繁，请稍后再试";boolean delKeyAfterSuccess() default true; // 成功后是否删除key
}AOP实现幂等性检查
@Aspect
@Component
public class IdempotentAspect {@Autowiredprivate RedisTemplate<String, String> redisTemplate;@Around("@annotation(idempotent)")public Object around(ProceedingJoinPoint joinPoint, Idempotent idempotent) throws Throwable {String key = generateKey(joinPoint, idempotent);boolean isExecuted = redisTemplate.hasKey(key);if (isExecuted) {throw new RuntimeException(idempotent.info());}redisTemplate.opsForValue().set(key, "executed", idempotent.expireTime(), idempotent.timeUnit());Object result = joinPoint.proceed();if (idempotent.delKeyAfterSuccess()) {redisTemplate.delete(key);}return result;}private String generateKey(JoinPoint joinPoint, Idempotent idempotent) {EvaluationContext context = new StandardEvaluationContext();String[] parameterNames = ((MethodSignature) joinPoint.getSignature()).getParameterNames();Object[] args = joinPoint.getArgs();for (int i = 0; i < parameterNames.length; i++) {context.setVariable(parameterNames[i], args[i]);}return ExpressionUtils.evaluateStringExpression(idempotent.key(), context);}
}使用Idempotent注解
@RestController
public class TestController {@PostMapping("/test")@Idempotent(expireTime = 30, info = "请求太频繁，请稍后再试", delKeyAfterSuccess = true)public ResponseEntity<?> testMethod(@RequestParam String param) {// 业务逻辑...return ResponseEntity.ok("操作成功");}
}通过定义专用的注解和使用AOP，我们能够以一种声明式的方式实现接口幂等性。这种方法不仅代码侵入性低，而且易于维护和扩展。
欢迎关注我的公众号“程序员洋哥”，原创技术文章第一时间推送。
