签名验证这事儿，很多开发者容易陷入一个误区：以为只要给参数做个MD5加盐就万事大吉了。其实，真正的安全防线，远不止一个哈希算法那么简单。核心在于构建一个从请求入口就开始的、环环相扣的验证闭环，而不仅仅是“加不加盐”的问题。
这个闭环的关键，在于四个要素的紧密配合：时间戳、随机串、参数归一化，以及原始数据的字节级拼接。缺了任何一环，都可能给攻击者留下可乘之机。
签名必须在中间件统一校验
把签名验证逻辑写在控制器里，就好比把门锁装在卧室——等请求走到这一步，它早就已经“登堂入室”了。恶意参数可能已经触发了数据库写入、信息发送甚至库存扣减等业务操作，为时已晚。
ThinkPHP 6+ 框架提供了清晰的中间件机制，特别是 beforeAction 钩子，非常适合用来做统一的请求拦截。所有携带 sign 参数的请求，都应该在这里被精准地“卡”住。
- 中间件路径：建议放在
app/middleware/SignCheckMiddleware.php。 - 注册位置：在
app/middleware.php中全局启用，或者针对特定路由组启用。 - 失败响应：一旦验签失败，必须立即终止请求流，返回统一的错误信息，例如：
return json(['code'=>401,'msg'=>'Unauthorized'])->send(); exit;。
原始数据必须字节级一致，别用 param() 取参
这是最容易踩坑的地方。客户端严格按照UTF-8编码拼接出待签名字符串，但如果服务端图省事，直接用 $this->request->param() 获取参数，麻烦就来了。这个方法内部会自动进行 trim、urldecode、类型转换等处理，比如把空格变成 + 号，这会导致两端拼接出的原始字符串在字节层面不一致，签名自然对不上。
正确的做法是分情况处理：
- 表单请求（
application/x-www-form-urlencoded）：分别用$this->request->get()和$this->request->post()获取原始GET和POST参数，合并后使用ksort()排序。 - JSON请求（
application/json）：先判断请求头，然后用$this->request->getContent()读取原始请求体，json_decode($raw, true)解析后再排序。 - 统一处理：所有参数值建议统一做一次
trim()和mb_convert_encoding($val, 'UTF-8', 'UTF-8')来强制编码，确保编码一致。 - 排除字段：像
sign、signature、sign_type这类签名相关的参数，必须在拼接签名原文前就从参数数组中移除（unset）。
签名原文拼接规则不能松动
MD5加盐只是最后一步，前面拼接的“原文”才是签名的灵魂。这个原文必须包含动态因子、业务参数和私钥，并且顺序固定、不可预测。
- 必含三要素：当前时间戳（
timestamp，精确到秒）、一个16位的随机字符串（nonce）、以及服务端独有的密钥（secret）。 - 业务参数处理：将所有非排除字段的键（key）按字典序升序排列，然后使用
http_build_query($params, '', '&', PHP_QUERY_RFC3986)进行标准化拼接，这样可以确保空格等特殊字符被正确编码。 - 完整签名原文：格式通常为
拼接后的业务参数 & timestamp=xxx & nonce=yyy，最后再追加上密钥secret。 - 哈希计算：推荐使用
strtoupper(md5($raw_string . $secret))。注意，客户端和服务端对签名结果的大小写约定必须严格一致。
防重放和防暴力的关键配套措施
如果只校验签名本身，那这套机制依然很脆弱。没有配套的防御措施，攻击者完全可以截获一个合法的请求包，反复重放。因此，时间窗口、随机串去重和请求限流这三道屏障必不可少。
timestamp校验：只接受服务器当前时间前后300秒（可配置）内的请求，超时的直接拒绝，防止请求被延迟重放。nonce去重：将每次请求的随机串存入Redis，键名可设计为"nonce:{$app_id}:{$nonce}"，并设置300秒的TTL。如果发现同一个随机串在有效期内再次出现，则判定为重放攻击。- 请求限流：针对同一个
app_id或IP地址，如果在短时间内（如10分钟）连续出现5次验签失败，则触发限流机制，暂时阻止其后续请求。 - 错误提示：验签失败时，永远返回统一的、模糊的错误信息，如
{"code":401,"msg":"Unauthorized"}，不要暴露是时间戳不对、签名错误还是随机串重复等具体原因，避免给攻击者提供调试信息。 - 日志脱敏：记录请求日志时，务必过滤掉
password、token、id_card等敏感字段，防止敏感信息泄露。
