ThinkPHP5.1需主动实现幂等性，核心是全局唯一指纹+Redis集中校验+数据库唯一索引兜底；指纹由用户ID、URI、排序后参数JSON的md5构成，配合X-Idempotency-Key头与60–300秒缓存窗口，通过Cache::remember原子操作及条件更新保障高并发下准确拦截重复请求。
ThinkPHP5.1 本身不内置幂等性保障机制，分布式集群环境下更需主动设计。核心思路是：**用全局唯一标识 + 集中式状态记录 + 安全校验时机**，三者缺一不可。
关键：统一请求指纹与幂等窗口期
每个请求必须生成稳定、可复现的指纹，且排除动态字段（如时间戳、nonce、随机字符串）。推荐组合方式：
- 用户ID + 接口URI + 关键业务参数JSON排序后md5（例如订单创建：user_id=123, uri=/api/order, params={"sku_id":456,"num":2} → md5("123#/api/order#{"num":2,"sku_id":456}")）
- 前端在页面加载时生成一次 X-Idempotency-Key（UUID），后续该会话内所有幂等请求复用此值，服务端仅校验其存在性和长度（32–64字符），不依赖其内容唯一性
- 幂等缓存有效期设为60～300秒——太短拦不住网络重试，太长占Redis内存且可能误拒合法重入
必须用 Redis 做幂等状态存储
数据库或Session无法支撑高并发下的快速判重，TP5.1应配置Redis为默认缓存驱动，并在中间件中调用 Cache::remember() 实现原子性判存执行：
Cache::remember('idempotent_'.$fingerprint, $ttl, function() use ($request) { /* 执行业务逻辑并返回结果 */ })- 该方法天然规避竞态：未命中时写入缓存并执行；命中则直接返回缓存值，无需额外加锁
- 避免手写
Cache::has() + Cache::set()，否则在高并发下可能出现两次都未命中、重复执行业务逻辑
中间件中完成校验与响应透传
新建中间件 app/middleware/Idempotent.php，注册到全局中间件队列（位置须早于路由解析）：
立即学习“PHP免费学习笔记（深入）”；
- 先取
request()->header('X-Idempotency-Key')，空值或空白字符直接拒绝（防止所有无头请求撞同一缓存桶） - 生成指纹后调用
Cache::remember()，若命中，需原样返回首次成功响应体（含HTTP状态码、JSON结构、业务数据），不能简单返回 success 数组 - 若业务逻辑抛异常，
Cache::remember()不会写入缓存，下次同请求仍会执行——符合“只对成功操作幂等”的语义
数据库层兜底：唯一索引+条件更新
Redis只是前置加速，最终一致性必须靠数据库约束：
- 对插入型操作（如订单、流水、核销记录），在表中添加联合唯一索引，如
UNIQUE KEY `uk_user_order` (`user_id`, `biz_type`, `biz_id`) - 对更新型操作（如支付状态变更），使用条件更新：
UPDATE trade SET status='paid' WHERE id=? AND status='unpaid'，检查受影响行数为0即判定重复 - TP5.1中可用
$result = Db::name('trade')->where(['id'=>$id,'status'=>'unpaid'])->update(['status'=>'paid'])，$result === 0 即幂等拦截成功
