Laravel应用在cPanel部署后白屏及报错问题求助

错误成因 #

1. 核心问题：方法不存在
   Illuminate\Foundation\Application::handleRequest并非Laravel框架标准方法，出现该错误的主要原因：

• 版本不兼容：本地开发所用Laravel版本与服务器上的版本不一致，或代码中误调用了框架不存在的方法。
• Vendor目录损坏：部署时依赖安装中断、文件传输丢失，导致框架核心文件缺失，无法找到对应方法定义。

2. Quirks Mode警告的关联
   浏览器提示怪异模式是错误的结果而非原因——PHP致命错误中断了页面执行流程，Laravel无法输出正常的<!DOCTYPE html>开头的HTML文档，浏览器自动切换到怪异模式渲染空白页面。

解决步骤 #

1. 核对版本与重建依赖 #

• 对比本地与服务器的Laravel版本：本地执行php artisan --version，服务器端通过SSH进入项目根目录执行相同命令，或查看composer.lock中laravel/framework的版本号，确保两者完全一致。
• 重建Vendor目录：

  # 删除损坏的依赖目录
  rm -rf vendor
  # 生产环境安装依赖（跳过开发依赖）
  composer install --no-dev --optimize-autoloader
  

  确保安装过程无报错，网络连接正常。

2. 修正入口文件与文档根配置 #

• 检查入口文件：确认public/index.php的启动代码符合Laravel标准流程（通过Kernel处理请求，而非直接调用Application的handleRequest），正确代码如下：

  <?php
  
  use Illuminate\Contracts\Http\Kernel;
  use Illuminate\Http\Request;
  
  define('LARAVEL_START', microtime(true));
  
  require __DIR__.'/../vendor/autoload.php';
  
  $app = require_once __DIR__.'/../bootstrap/app.php';
  
  $kernel = $app->make(Kernel::class);
  
  $response = $kernel->handle(
      $request = Request::capture()
  );
  
  $response->send();
  
  $kernel->terminate($request, $response);
  

  若你的入口文件存在$app->handleRequest()调用，直接替换为上述标准代码。

• 调整cPanel文档根：Laravel规范部署要求将public目录设为服务器文档根。在cPanel的域名管理或文件管理器中，将域名的文档根路径修改为项目的public目录（例如原路径为public_html，可改为public_html/public；或把Laravel项目放在public_html外，将public目录内容移至public_html）。

3. 清除Laravel缓存 #

执行以下命令清除各类缓存文件，避免旧配置干扰：

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

若无法使用SSH执行artisan命令，可手动删除bootstrap/cache目录下的所有文件。

4. 确认PHP版本兼容性 #

在cPanel的PHP版本选择器中，检查当前PHP版本是否符合项目所用Laravel的要求：

• Laravel 10：PHP 8.1+
• Laravel 9：PHP 8.0+
• Laravel 8：PHP 7.3+
  若版本不符，切换到符合要求的PHP版本。

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