Laravel 中请求输入为空的常见原因及解决方案

当 laravel 接收 json 请求时，`$request->all()` 返回空数组，通常是因为未正确设置请求头、未启用 json 输入解析，或混淆了 `php://input` 与 laravel 的请求对象行为。本文详解根本原因并提供可落地的修复方案。

在 Laravel 中，$request->all() 无法获取 JSON 请求体数据，并非 Bug，而是由底层请求解析机制决定的。Laravel 默认仅在 Content-Type: application/x-www-form-urlencoded 或 multipart/form-data 时自动解析并填充 $request->all()；而对 application/json 请求，必须显式启用 JSON 输入解析支持——这依赖于两个关键前提：

✅ 必须满足的两个条件

1. 请求头 Content-Type 必须精确为 application/json（注意：末尾不能带参数如 application/json; charset=utf-8，尽管现代 Laravel 版本（v8.34+）已放宽此限制，但低版本仍敏感）；
2. Laravel 需成功读取并解码 php://input 流——这意味着中间件或服务器配置不能提前消耗该流（例如：file_get_contents('php://input') 被调用一次后，后续读取将返回空）。

? 验证方式：在控制器中添加 dd($request->header('content-type'), $request->json()->all());，确认 header 值与 JSON 解析结果。

✅ 正确读取 JSON 请求的推荐方式

public function feedback(Request $request)
{
    // ✅ 推荐：使用 json() 方法（Laravel v5.5+）
    $data = $request->json()->all(); // 返回完整关联数组

    // ✅ 或按需取值（更安全，支持嵌套）
    $message = $request->input('message');     // 自动兼容 form/json
    $specs   = $request->input('specs', 'N/A'); // 支持默认值

    // ✅ 强验证（推荐生产环境）
    $validated = $request->validate([
        'message' => 'required|string|min:5',
        'specs'   => 'nullable|string',
    ]);

    dd($data, $message, $validated);
}

⚠️ 注意：$request->input() 是最佳通用方法，它内部自动适配 x-www-form-urlencoded、JSON 和 query string，无需区分来源；而 $request->all() 在纯 JSON 场景下可能为空（尤其在早期 Laravel 版本或自定义中间件干扰时）。

❌ 常见错误排查清单

• [ ] 检查 Postman/curl 是否误设 Content-Type: text/plain 或缺失 Content-Type 头；
• [ ] 确认 JSON 格式合法（你示例中 "specs": "Device Info", 后多了一个逗号 → 无效 JSON，会导致 Laravel 解析失败）；
• [ ] 避免在控制器中多次调用 file_get_contents('php://input') ——该流只能读取一次；
• [ ] 检查是否启用了 TrimStrings 或 ConvertEmptyStringsToNull 中间件，它们可能静默修改输入（罕见但需排除）；
• [ ] 若使用 Nginx，确认未配置 fastcgi_buffering off 或 client_max_body_size 过小导致请求截断。

✅ 最终建议：API 开发黄金实践

• 统一使用 $request->input() 或 $request->json()->all()，避免 $request->all()；
• 始终配合 validate() 进行强约束，而非依赖原始输入；
• 在 API 路由中显式指定 middleware('api')（确保 EnsureFrontendRequestsAreStateful 等中间件不干扰）；
• 开发期开启 APP_DEBUG=true，关注 storage/logs/laravel.log 中的 Symfony\Component\HttpKernel\Exception\BadRequestHttpException: Invalid JSON. 类错误。

通过以上配置与编码习惯，即可彻底解决 Laravel JSON 请求输入为空的问题，确保 API 稳健可靠。