完整目录

01-基础概念

定义与核心原则

• 什么是幂等性
• HTTP 方法与幂等性
• 幂等性与安全性

为什么需要幂等性

• 网络超时与重试机制
• 前端用户误操作
• 消息队列的重复消费
• 分布式系统的局部失败

02-核心实现模式

Token 机制

• 同步锁模式
• 预生成 Token 模式
• Redis 实现细节

唯一索引

• 数据库唯一约束
• 捕获异常处理

乐观锁

• 版本号机制
• 状态机流转控制

分布式锁

• Redis 分布式锁
• Zookeeper 分布式锁

全局唯一 ID

• 请求 ID 去重
• 业务主键去重

03-技术栈实现指南

.NET 生态

• ASP.NET Core 中间件实现
• 使用 Idempotency.AspNetCore 库
• 基于 IHostedService 的后台幂等处理

Node.js 生态

• Express/Koa 中间件实现
• 使用 ioredis 进行原子操作
• 事件驱动架构中的幂等处理

数据库层

• PostgreSQL 唯一索引与事务
• MySQL 唯一索引与事务
• PostgreSQL 冲突处理

Redis 层

• Lua 脚本原子性校验
• Redisson 框架使用

04-场景化解决方案

支付与交易

• 防止重复扣款
• 支付回调去重

订单系统

• 防止重复下单
• 库存扣减幂等

数据同步

• ETL 任务断点续传
• 第三方数据拉取去重

表单提交

• 用户注册防重
• 信息修改防重

05-架构与运维

API 网关层

• 网关级限流与去重
• 请求指纹识别

监控与告警

• 幂等冲突日志监控
• 异常重试频率告警

测试策略

• 并发压力测试
• 混沌工程模拟网络抖动

06-常见问题与陷阱

性能损耗

• 数据库锁竞争
• Redis 网络开销

数据一致性

• 删除 Token 与执行业务的原子性
• 分布式事务中的幂等处理

边界情况

• Token 过期处理
• 极端并发下的穿透问题