Laravel 5.6返回大体积JSON时出现空响应的解决方法

1. 调整PHP运行配置 #

• 先调高内存限制，大视图渲染+JSON序列化容易触发默认内存上限，可在控制器方法开头临时设置：
  ini_set('memory_limit', '256M');
  也可修改php.ini的memory_limit参数为256M，修改后重启php-fpm/Apache生效。
• 检查output_buffering配置，若缓冲区上限小于5M会截断内容，可将php.ini中output_buffering设置为On或者10M。

2. 改用流式输出响应 #

Laravel默认的response()->json()会先把全部内容序列化到内存再输出，大体积内容极易触发内存溢出，改为流式输出直接将内容推送到浏览器：

// 替换为你的实际业务参数
$hasMore = true;
$viewContent = view('your.view')->render();

return response()->stream(function () use ($hasMore, $viewContent) {
    echo json_encode([
        'hasMore' => $hasMore,
        'data' => $viewContent
    ], JSON_UNESCAPED_UNICODE);
}, 200, [
    'Content-Type' => 'application/json',
]);

如果之前有其他输出缓存，可在返回前加ob_end_clean();清空缓冲区，避免内容被干扰。

3. 排查JSON序列化错误 #

视图渲染后的内容如果包含特殊编码字符、BOM头，会导致json_encode执行失败返回空，可在返回前加校验逻辑确认序列化正常：

$payload = [
    'hasMore' => $hasMore,
    'data' => $viewContent
];
json_encode($payload);
if (json_last_error() !== JSON_ERROR_NONE) {
    // 输出错误信息排查编码、特殊字符类问题
    dd(json_last_error_msg());
}

4. 调整Web服务器配置 #

如果使用Nginx，默认的fastcgi缓冲区过小会截断大响应，在Nginx配置中添加/修改以下参数：

fastcgi_buffer_size 128k;
fastcgi_buffers 4 256k;
fastcgi_busy_buffers_size 256k;

修改后重启Nginx生效，同时可临时关闭gzip压缩测试，排除压缩模块处理大内容出错的可能。

内容的提问来源于stack exchange，提问作者Q_Nick