Java中轻量级本地幂等性控制通过ConcurrentHashMap内存缓存+自定义IdempotentRejectException异常拦截实现，适用于单机短生命周期场景；key采用“业务类型:ID:时间桶”格式分桶，配合定时清理防OOM；仅限单JVM有效，多实例部署不适用。
Java中利用try-catch实现轻量级本地幂等性控制，核心思路是：**不依赖外部存储（如Redis、DB唯一索引），而是通过JVM内存中的状态缓存 + 异常拦截机制，在单机、短生命周期场景下快速识别并拒绝重复执行**。它适用于定时任务去重、接口防连击、消息消费端本地去重等对一致性要求不高但需低开销的场景。
用ConcurrentHashMap缓存执行痕迹
在类级别或Spring Bean中定义线程安全的缓存容器，以“业务标识+时间窗口”为key，记录最近一次执行时间或标记：
- key建议格式：
businessType:orderId:timestampBucket（例如pay:10023:2024052010，按小时分桶避免无限增长） - value可为
Boolean.TRUE或System.nanoTime()，仅作存在性判断，无需持久化 - 配合
putIfAbsent()原子操作，天然避免并发重复写入
在关键入口用try-catch包裹并捕获自定义重复异常
不依赖finally或return逻辑判断，而是主动抛出、捕获特定异常来中断流程：
- 定义轻量异常：
static class IdempotentRejectException extends RuntimeException - 执行前检查缓存，命中则
throw new IdempotentRejectException("duplicate request") - 外层用
try-catch(IdempotentRejectException e)捕获，统一返回提示或记录日志，不打印堆栈 - 避免用
Exception泛捕获，防止掩盖真实错误
结合TTL自动清理，防止内存泄漏
本地缓存必须有生命周期管理，否则OOM风险高：
立即学习“Java免费学习笔记（深入）”；
- 不使用Guava Cache或Caffeine（引入额外依赖），改用
ConcurrentHashMap+ 定时清理线程（如ScheduledExecutorService每5分钟扫描过期项） - key中嵌入时间桶（如小时戳），清理时只需删除早于当前桶的全部key，O(1)判断，无遍历压力
- value可封装为
IdempotentRecord{ timestamp, expireAt }，但更推荐“分桶+简单字符串key”，保持轻量
注意适用边界：这不是分布式幂等
该方案只在单JVM进程内有效，多实例部署时完全失效：
- 适合：单机定时任务（如每天凌晨跑一次报表）、本地MQ消费者（Kafka单分区+单线程消费）、内部RPC接口的瞬时防刷
- 不适合：Web API对外暴露、集群部署的HTTP服务、跨节点消息处理
- 上线前务必确认部署模型——若用了K8s多副本或Tomcat集群，此方案会形同虚设
