单纯加时间戳不能防重放，因攻击者可篡改timestamp为合法值并重发；必须结合nonce唯一性校验、签名绑定timestamp+nonce+参数、严格时序控制（≤300秒偏差且不接受未来时间）及前后端参数归一化。
为什么单纯加时间戳不能防重放
时间戳只是防重放的必要条件，不是充分条件。攻击者截获一次请求后，把 timestamp 改成当前合法时间（比如只差几秒），再重发，服务端一验证就过了——因为时间在窗口期内，签名也对得上（如果签名没绑定时间戳或没校验唯一性）。
关键点在于：签名必须和时间戳、随机数强绑定，且服务端必须拒绝重复的 nonce 或过期/超前的 timestamp。
实操建议：
- 时间戳用
time()（秒级即可，毫秒反而增加时钟漂移风险） - 必须校验
timestamp与服务器当前时间偏差 ≤ 300 秒（5 分钟），且timestamp不能大于服务端当前时间（防“未来请求”） - 每个请求必须携带唯一
nonce（如 UUIDv4 或 16 字节随机字符串），服务端用 Redis 缓存并设置 300 秒过期 - 签名原文必须包含
timestamp+nonce+ 请求参数（按字典序排序拼接），缺一不可
ThinkPHP 中签名验证的正确写法（以中间件为例）
别在控制器里手写验签逻辑，容易漏校验或绕过。推荐用中间件统一拦截，在 app/middleware/CheckSign.php 里做。
立即学习“PHP免费学习笔记（深入）”；
常见错误现象：Signature not match 但参数明明没动；或者 POST JSON 请求体被重复读取导致后续业务拿不到数据。
实操建议：
- 在中间件开头调用
$request->getRawBody()一次性读取原始请求体，再解析为数组，避免多次读取失败 - 签名字段统一约定为
sign，从$request->param()和$request->post()都要兼容获取（GET/POST 混合场景） - 签名算法用
hash_hmac('sha256', $signStr, $secretKey)，$secretKey不硬编码，从配置或环境变量读取 - 验证失败直接
throw new HttpException(401, 'Invalid signature')，不要返回 200+ 错误码
Redis 存 nonce 的坑：过期时间与并发冲突
很多人用 SETNX + EXPIRE 两步存 nonce，结果在高并发下出现竞态：A 请求刚 SETNX 成功，还没来得及 EXPIRE，B 请求就判断到 key 不存在又 SETNX 成功了。
这不是 ThinkPHP 的问题，是 Redis 原生命令的原子性缺失。
实操建议：
- 改用
SET命令的原子参数：$redis->set($key, 1, ['nx', 'ex' => 300]) -
noncekey 建议带前缀，比如sign:nonce:+substr(md5($nonce), 0, 8)，避免长字符串做 key 影响性能 - 如果 Redis 不可用，降级策略只能是关闭 nonce 校验（日志告警），**绝不能静默跳过**——否则防重放形同虚设
- 注意 Redis 连接超时和连接池配置，ThinkPHP 默认的
redis.max_active太小会导致验签卡顿
前端传参顺序错乱导致签名失败
签名失败最常被忽略的原因：前端 JS 对象转 URL 参数时，键名顺序不固定（尤其用 JSON.stringify 或 for...in 遍历对象），而服务端按字典序拼接，两边不一致，签名自然对不上。
这不是加密问题，是数据序列化一致性问题。
实操建议：
- 前端必须显式排序参数键名（如用
Object.keys(params).sort()再拼接） - 服务端排序前，先过滤掉签名相关字段（
sign、timestamp、nonce）再排序剩余参数 - 空值参数（
null/undefined/空字符串）统一转成空字符串参与签名，避免前后端空值处理差异 - URL 编码必须严格：用
encodeURIComponent（前端）和rawurlencode（PHP）——别用encodeURI或urlencode，它们处理规则不同
真正难的不是写签名函数，而是前后端对「参数归一化」的理解是否完全一致。一个字母大小写、一个空格、一个编码层级的偏差，都会让签名失效。上线前务必用抓包工具比对前后端生成的原始 signStr 字符串是否一字不差。
