ThinkPHP 8.0 中 API 参数规范化需在中间件中按 Content-Type 分类处理原始参数，精准 Trim 白名单字段，统一空值归一化，并调用 merge() 或 setPost() 确保 param() 和 post() 一致性。
ThinkPHP 8.0 中实现 API 请求参数的规范化（如自动 Trim）不能靠全局无差别处理，必须结合请求类型、字段语义和安全边界来精准控制。核心思路是：在中间件中统一读取原始参数 → 按规则清洗 → 强制刷新请求实例缓存 → 确保后续所有 param() 调用都基于新值。
区分 Content-Type 处理原始输入
GET、POST 表单、JSON 请求的参数来源不同，需分别应对：
-
application/x-www-form-urlencoded 或 multipart/form-data：直接用
$request->param()获取已解析参数，再逐字段 trim 和空值归一化 -
application/json：必须在
AppInit阶段或早期中间件中调用$request->getRawContent()解析，否则param()已固化，merge()无效 -
带 query 的 POST/PUT：需手动合并
$request->get()与 body 解析结果，避免丢失 URL 参数
精准 Trim，避开敏感字段
不能对所有字符串字段无差别 trim，尤其要跳过以下场景：
- 支付回调中的
sign、notify_id、full_name等含空格即失效的字段 - 富文本内容、密码提示语、JWT token、base64 编码值等空格敏感数据
- 前端明确传入
" hello "表达格式意图的字段（如备注、标题前缀）
建议在中间件中维护一个白名单数组（如 ['name', 'title', 'email', 'mobile']），只对这些字段执行 trim()；其余字段原样保留。
立即学习“PHP免费学习笔记（深入）”；
统一空值归一化，为验证铺路
前端可能传 null、空字符串 ""、空白字符串 " "，而 ThinkPHP 默认校验会把 null 当作“字段缺失”跳过，"" 又可能被当成合法值。解决办法是在中间件里统一转换：
- 对每个字段判断：
is_null($v) ? '' : (is_string($v) ? trim($v) : $v) - 注意保留数字
0、字符串"0"、布尔false等有效非空值，不误删 - 处理完后调用
$request->merge($cleanedParams)，确保后续$request->param()、input()都返回清洗后结果
避坑要点：别让 post() 成为漏网之鱼
$request->post() 是只读缓存，首次调用后就固化，merge() 不会影响它。若控制器仍依赖 post()，会出现参数不一致问题：
- 方案一（推荐）：全程弃用
post()，只用param()—— 它受merge()影响，行为一致 - 方案二（TP8.0+）：中间件末尾调用
$request->setPost($cleanedParams)同步更新（确认框架版本支持该方法） - 切勿在控制器中先调
post()再改param()，顺序错乱会导致部分逻辑读旧值、部分读新值
