Laravel接口始终返回200状态码及Content-Type异常排查求助

问题现象 #

• 所有接口始终返回200状态码，与代码中定义的实际响应状态（如404）不符
• 日志确认初始响应头已设置为Content-Type: application/json，但后续被修改为text/html
• 需要追踪响应流转路径，定位头信息修改的具体阶段，同时确认该问题是否与GoDaddy部署环境相关

相关代码 #

登录接口代码 #

public function login(LoginRequest $request)
{
    $subject = 'Invalid information enetered.Please try again'; 
    $response = response()->negative_response(false,$subject, 404);
    $email = strtolower(trim(data_get($request,'email',null)));
    $password = data_get($request,'password');
    $input_language = data_get($request,"language",null);
    $language = $input_language == "EN" ? "english" : "spanish";
    $user_data = LoginPageUserDetail::where('email',$email)->first();
    $token_type = 'login';
    if($user_data)
    {
        if(password_verify($password,data_get($user_data,'password'))) {
            if($user_data->is_active == 1)
            {
                $user_id = data_get($user_data,'id',null);
                if(!$user_data->language)
                {
                    $language_data =  UserLanguage::assignLanguageToUser($language);
                    $language_id = data_get($language_data,"id",null);
                    User::updateUserData($user_id,['language_id'=>$language_id]);
                } 
                $token_data =   Usertoken::addToken($user_id,$token_type);
                $token = data_get($token_data,'token',null);
                $user_data= new UserResource($user_data,$token);
                $subject = 'Successfully Login';
                $response =  response()->positive_response(true,$subject,$user_data,200);
            }
        }
    }
    CrewLog::saveLog($subject,$this->current_url,$this->current_function_name,$this->current_request_ip,$email);
    return $response;
}

响应宏定义代码 #

public function boot(): void
{
    Response::macro('positive_response', function ($error,$message,$data,$status_code) {
        return response()->json([
            'success' => $error,
            'message' => $message,
            'data'  => $data
        ], $status_code);
    });

    Response::macro('negative_response', function ($error, $message, $status_code) {
        return response()->json([
            'success' => $error,
            'message' => $message,
            'data'  => null
        ], $status_code);
    });
}

排查与解决思路 #

1. 追踪响应流程，定位头信息修改节点 #

• 监听ResponsePrepared事件：在App\Providers\EventServiceProvider中注册Illuminate\Http\Events\ResponsePrepared事件，创建监听器记录每个阶段的响应状态码和头信息：

  // EventServiceProvider.php
  protected $listen = [
      \Illuminate\Http\Events\ResponsePrepared::class => [
          \App\Listeners\LogResponseChanges::class,
      ],
  ];
  

  监听器实现：

  // LogResponseChanges.php
  public function handle(\Illuminate\Http\Events\ResponsePrepared $event)
  {
      logger()->info('Response status & headers:', [
          'status_code' => $event->response->getStatusCode(),
          'content_type' => $event->response->headers->get('Content-Type'),
          'request_path' => request()->path(),
      ]);
  }
  

• 添加调试中间件：在全局中间件栈末尾添加自定义中间件，捕获响应发送前的最终状态：

  // DebugResponseMiddleware.php
  public function handle($request, Closure $next)
  {
      $response = $next($request);
      logger()->info('Final response before send:', [
          'status' => $response->getStatusCode(),
          'content_type' => $response->headers->get('Content-Type'),
      ]);
      return $response;
  }
  

  将该中间件加入app/Http/Kernel.php的$middleware数组末尾。
• 断点调试：开启Xdebug，在控制器返回响应后、中间件处理时、框架发送响应前等关键节点设置断点，直接查看响应对象的属性变化。

2. 排查状态码被覆盖的原因 #

• 检查异常处理器：查看App\Exceptions\Handler的render方法，确认是否存在强制将异常转为200状态HTML页面的逻辑。
• 验证路由配置：确认路由是否正确指向目标控制器方法，排查是否有优先级更高的路由规则（如正则路由）导致请求被错误转发。
• 绕过响应宏测试：在控制器中直接使用response()->json([...], 404)替代自定义宏调用，测试是否能正常返回非200状态码，排除宏定义的潜在问题。

3. GoDaddy服务器环境排查 #

• 测试服务器直接响应：用curl命令直接访问服务器API，对比返回结果与本地环境的差异：

  curl -I -X POST https://your-domain.com/api/login -d "email=test@example.com&password=test"
  

  若返回的状态码或头信息与Laravel日志不符，说明服务器配置（如Apache/Nginx重定向规则）修改了响应。
• 检查.htaccess配置：排查项目根目录的.htaccess文件，确认是否存在修改Content-Type头或重定向错误状态码的规则。
• 对比PHP配置：在控制器中添加phpinfo()输出，对比本地与GoDaddy环境的display_errors、output_buffering等配置项，排查是否因配置差异导致响应被覆盖。

4. 临时修复与验证 #

• 在响应宏中强制指定Content-Type头：

  return response()->json([...], $status_code)->header('Content-Type', 'application/json');
  

• 在控制器返回响应前手动重置状态码和头：

  $response->setStatusCode(404)->header('Content-Type', 'application/json');
  return $response;
  

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