Laravel返回响应时附带HTTP头部文本，如何去除该干扰内容？

问题背景 #

前端实现（React + jQuery Ajax） #

$.ajax({
  url: ...
  method: 'POST',
  contentType: 'application/json',
  dataType: 'json',
  success: (response) => { ... },
  error: (err) => { ... },
});

后端实现（Laravel 8.0控制器） #

app/Http/Controllers/Ajax.php中的处理方法：

public function sayHello(Request $request): string
{
  return response()->json([
      'status' => true,
  ])->setStatusCode(200);
}

异常现象 #

后端返回内容包含完整HTTP头部文本，导致前端无法正常解析目标JSON数据：

HTTP/1.0 200 OK
Cache-Control: no-cache, private
Content-Type: application/json
Date: Tue, 30 Aug 2022 22:03:48 GMT

{"status":true}

解决方案 #

1. 修正控制器方法的返回类型 #

控制器方法声明返回string类型，但response()->json()返回的是Illuminate\Http\JsonResponse对象，类型不匹配会触发Laravel错误处理，将整个HTTP响应（含头部）转为字符串输出。

修改方式二选一：

• 明确返回JsonResponse类型：

use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;

public function sayHello(Request $request): JsonResponse
{
  return response()->json([
      'status' => true,
  ])->setStatusCode(200);
}

• 移除返回类型声明：

public function sayHello(Request $request)
{
  return response()->json([
      'status' => true,
  ])->setStatusCode(200);
}

2. 检查路由配置 #

确保路由未手动调用send()方法发送响应，Laravel会自动处理响应输出。

错误示例（会导致头部被输出）：

Route::post('/say-hello', function() {
  return response()->json(['status' => true])->send();
});

正确配置：

Route::post('/say-hello', [AjaxController::class, 'sayHello']);

3. 排查中间件或全局代码干扰 #

若以上步骤无效，检查项目中的自定义中间件、AppServiceProvider的boot方法或第三方包，确认是否存在手动输出响应、篡改响应格式的代码。比如部分调试工具类中间件可能会强制输出完整HTTP响应文本。

前端临时兼容方案（优先修复后端） #

如果后端暂时无法调整，可在前端回调中手动提取JSON数据：

success: (response) => {
  // 以空行分割响应文本，提取后续的JSON内容
  const jsonContent = response.split('\n\n')[1];
  const parsedData = JSON.parse(jsonContent);
  // 处理解析后的数据
},

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