签名验证必须放在中间件里，不能在控制器中做；因控制器执行时路由已匹配、参数已解析，恶意请求可能已触发业务逻辑或打日志，且90%验签失败源于客户端与服务端参数编码不一致（如urldecode差异）、中文编码未统一、空格/BOM等隐藏字符干扰，须严格按路径+字典序参数+sign_version+密钥拼接签名原文并剔除sign字段。
签名验证必须放在中间件里，不能在控制器中做——控制器执行时请求已解析、路由已匹配、业务逻辑可能已被触发，恶意请求早就有机会打日志或调用敏感方法。
为什么验签失败 90% 是参数没对齐
服务端拿到的 $request->param() 是框架自动 urldecode() 后的结果，但客户端签名时用的是原始 URL 编码字符串（比如 a=x%20y），两者拼接后哈希值必然不同。
- 必须统一用
rawurlencode()对每个 value 单独编码，不能对整个字符串再 urlencode - 中文参数要确保前后端都用 UTF-8，且 PHP 内部编码设为
mb_internal_encoding('UTF-8') - 空格、换行、BOM 头、隐藏 Unicode 字符都会导致签名不一致，建议用
trim()+str_replace(["\r", "\n"], '', $v)预处理 - 调试时可临时加
debug_sign=1参数，输出服务端构造的签名原文，和客户端比对
签名原文怎么拼才不会出错
签名原文不是“把所有参数连起来”，而是有严格顺序和过滤规则的字符串：接口路径 + 按 key 字典序排列的参数键值对 + sign_version（如有） + 密钥，其中 sign 字段必须剔除。
- 先取
$request->url(true)得到不含域名的路径（如/api/v1/user） - 合并
$request->get()和$request->post()，避免$request->param()自动合并或丢字段 - 用
ksort()排序后，遍历数组对每个$k和$v分别rawurlencode()，拼成$k=$v形式 - 若支持 JSON 请求体，需先判断
$request->header('content-type')是否含application/json，再用$request->getContent()取原始 body 并参与拼接 - 最后追加
rawurlencode($secretKey)，别漏掉
如何安全加载和复用 RSA 密钥
每次验签都读文件 + openssl_pkey_get_private() 解析，高并发下会成为 I/O 和 CPU 瓶颈；硬编码密钥更不可取。
- 密钥文件应放在
runtime/keys/private.pem这类非 Web 可访问路径 - 用
think\Container::getInstance()->get('rsa_private_key')封装单例，首次加载后缓存 resource 类型返回值 - 公钥格式必须是 PKCS#8（
-----BEGIN PUBLIC KEY-----），不是 PKCS#1（-----BEGIN RSA PUBLIC KEY-----），PHP 8.0+ 默认不认后者 - 验签时第三个参数必须显式传
OPENSSL_ALGO_SHA256，不能传字符串'sha256'
最易被忽略的一点：sign_version 必须作为独立参数传入（query 或 JSON 顶层字段），且验签前就要读取并选密钥——它本身要参与签名原文拼接，但 sign 字段必须排除在外。漏掉这个，多版本密钥切换就形同虚设。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
