getRawContent只能调用一次，因其底层依赖只读一次的php://input流；GET请求时恒为空，因HTTP规范无请求体；POST/JSON需校验Content-Type；TP6+已幂等封装，TP5.1需手动缓存。
getRawContent 为什么只能用一次
因为 $request->getRawContent() 底层调用的是 php://input 流，而该流在 PHP 中是只读一次的。第二次调用会返回空字符串或 false，不是 bug，是 PHP 的设计限制。
常见错误现象：
- 中间件里调了一次
getRawContent()做日志，控制器再调就拿不到原始 JSON - 签名验证和参数解析分别调用两次，后一次返回空，导致
json_decode()失败
正确做法：
- 在前置中间件中一次性读取并缓存到请求上下文：
$request->withAttr('raw_body', $request->getRawContent()) - 后续所有地方统一从
$request->attr('raw_body')取值，不再重复调用getRawContent() - 若已用过
file_get_contents('php://input')，getRawContent()必然失效，二者不可混用
GET 请求调用 getRawContent 返回空是正常的
$request->getRawContent() 对 GET 请求永远返回空，因为 HTTP 规范中 GET 没有请求体（body），参数全在 URL 查询字符串里。这不是框架问题，是协议本身决定的。
立即学习“PHP免费学习笔记（深入）”；
对应场景要换方法：
- 统计 GET 参数体积 → 改用
$request->server('QUERY_STRING')，再strlen() - 签名验证需拼接 GET 参数 → 用
$request->param()或$request->get()获取键值对，按字典序拼成字符串 - 不要对 GET 请求做
json_decode($request->getRawContent())，结果必为null
POST/JSON 请求必须配合 content-type 判断
getRawContent() 能拿到数据，但是否“有效”取决于请求头。比如 Content-Type: application/json 时它返回 JSON 字符串；而 application/x-www-form-urlencoded 时它可能为空（PHP 已把参数注入 $_POST）。
安全使用建议：
- 先判断类型：
if (strpos($request->header('content-type'), 'json') !== false) - 再读取：
$raw = $request->getRawContent(); if (empty($raw)) { throw new HttpException(400, 'Empty JSON body'); } - 对非 JSON 类型（如表单），别依赖
getRawContent()，改用$request->post()或手动拼接http_build_query($request->post()) - 上传文件（
multipart/form-data）下getRawContent()几乎总是空，此时应看$request->header('content-length')估算总流量
TP5.1 和 TP6+ 的行为差异
TP6+ 封装了 getRawContent() 并做了容错处理（如自动跳过 BOM、处理编码异常），TP5.1 没这个方法，直接裸用 file_get_contents('php://input') 风险更高。
关键区别点：
- TP5.1 中，
$this->input属性会缓存第一次读取结果，但手动调file_get_contents('php://input')会绕过缓存，造成不一致 - TP6+ 的
getRawContent()是幂等的（多次调用返回相同结果），前提是没被其他代码提前 consume - TP6.3+ 开始支持传参：
$request->getRawContent(true)表示强制重读（仅调试用，生产禁用）
最易被忽略的一点：中间件顺序。如果前面有日志中间件或签名中间件已调用过 getRawContent()，后面控制器再用就晚了——得靠 Request::bind() 或上下文属性透传。
