签名验证函数必须支持可配置算法和密钥轮换，参数应动态传入而非硬编码；需严格校验时间戳并处理时区；拼接签名原文须统一排序与编码规则；失败响应须脱敏且日志详尽。
签名验证函数必须支持可配置的算法和密钥轮换
硬编码 HMAC-SHA256 和固定密钥会让签名形同虚设。真实业务中，你得应对不同合作方用不同算法（md5、hmac-sha1）、不同密钥有效期（比如每小时轮换一次）、甚至同一接口在灰度期并行支持多套签名规则。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 把算法、密钥、签名字段名都作为函数参数传入，不要从 config 文件里全局读取——灰度或迁移时你会感谢这个设计
- 密钥建议通过
$_SERVER['SIGNING_KEY']或环境变量注入，避免出现在代码或日志中 - 对密钥加时间戳后缀（如
key_v2_20240901）并在验证时解析，方便识别过期签名 - 算法名统一转小写再比对，避免
SHA256和sha256不匹配
时间戳校验必须严格且带时区容错
只检查 timestamp 是否存在、是否为数字？远远不够。攻击者可以重放 5 分钟前的有效请求，只要你的服务器时间比对方快几秒，就可能误判。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
time()获取服务端当前 Unix 时间戳，与请求中的timestamp做差值判断，允许误差 ≤ 300 秒（5 分钟），超出直接拒绝 - 强制要求客户端传
timezone或tz_offset（单位秒），比如-28800表示 UTC+8；服务端还原成标准时间再比对 - 记录每次验证的
server_time和client_timestamp到 debug 日志，排查时区问题不抓瞎 - 禁止用
date('U')替代time()——前者受date_default_timezone_set()影响，不可靠
签名原文拼接顺序和编码必须与客户端完全一致
“我本地验得通，上线就失败”——90% 是因为拼接顺序或编码差异。PHP 的 http_build_query() 默认会 encode，而 Java 的 URLEncoder.encode() 默认用 UTF-8 但空格变 +，Go 的 url.Values.Encode() 把空格变 %20。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 约定所有参数按 key 字典序升序排列，再拼成
k1=v1&k2=v2格式（不含问号），**不使用http_build_query()** ——它会把+当空格处理，破坏一致性 - 手动遍历
ksort($params)后用rawurlencode()编码每个 value，key 不编码（除非协议明确要求） - 签名原文末尾追加密钥，即
$sign_str = $sorted_query . $secret_key，别漏掉 - 调试时打印出最终的
$sign_str和hash_hmac('sha256', $sign_str, $key)结果，和客户端日志逐字比对
验证失败时返回信息不能泄露细节
返回 {"code":401,"msg":"Invalid signature: hmac mismatch"} 就等于告诉攻击者“你猜对算法了，只是密钥错了”。更糟的是，把 openssl_encrypt() failed 这类 PHP 错误直接打出来。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 所有验证失败统一返回
{"code":401,"msg":"Unauthorized"}，不区分是时间超时、签名错、还是参数缺失 - 把具体错误写进 error_log，格式包含请求 ID、IP、原始参数、失败环节（如 "timestamp expired"），便于审计但不暴露给调用方
- 对高频失败 IP 做简单限流（比如 5 次/分钟），用
apcu_inc()计数，避免被暴力探测签名逻辑 - 上线前用 curl 模拟各种异常请求（错 timestamp、少 sign、乱序参数），确认响应体干净无敏感信息
签名不是加个 hash_hmac() 就完事。最易忽略的是：客户端和服务端对“相同字符串”的定义，往往差在一个空格、一个编码、一个时区偏移——这些地方不拉齐，安全就是纸糊的。
