Laravel应用移至public_html目录后空白页无日志报错问题排查

这种情况我碰到过好几次，大概率是文档根目录配置或者入口文件路径错误导致的，毕竟从子目录移到根目录，很多路径相关的配置都得跟着调整。下面一步步来排查和解决：

1. 服务器文档根目录未指向Laravel的public文件夹 #

这是最常见的原因。Laravel的入口文件是public/index.php，服务器必须把文档根目录（Document Root）指向public_html/public，而不是public_html本身。如果指向错了，访问时会直接加载项目根目录的文件（根目录没有可执行的入口），就会出现空白页。

解决方法：

• 如果你用cPanel：找到域名设置或文件管理器里的域名配置，把文档根目录从public_html改成public_html/public。
• 如果你用Nginx：打开站点配置文件，修改root字段为/path/to/public_html/public;，同时确保index指令里包含index.php。
• 如果你用Apache：优先推荐修改文档根目录；如果暂时改不了，可以在public_html的.htaccess里添加转发规则：

  <IfModule mod_rewrite.c>
      RewriteEngine On
      RewriteRule ^(.*)$ public/$1 [L]
  </IfModule>
  

  不过这种转发方式不如直接修改文档根目录安全规范。

2. public/index.php里的路径配置错误 #

如果服务器文档根已经指向public，但还是空白，可能是你误把public文件夹里的文件直接移到了public_html根目录（而非保留public文件夹），导致index.php里的相对路径失效。

解决方法：
打开public_html/index.php，检查这两行代码：

require __DIR__.'/../vendor/autoload.php';
$app = require_once __DIR__.'/../bootstrap/app.php';

如果vendor和bootstrap文件夹就在public_html根目录下，需要把路径里的../去掉，改成：

require __DIR__.'/vendor/autoload.php';
$app = require_once __DIR__.'/bootstrap/app.php';

不过还是强烈建议保留public文件夹，把文档根指向它，避免把非公开代码暴露在网站根目录下。

3. 文件夹权限问题 #

虽然日志没报错，但还是要检查storage和bootstrap/cache的权限——Laravel需要这两个文件夹有写入权限才能正常运行。

解决方法：
进入public_html目录后，在终端执行：

chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache # 针对Apache/Nginx运行用户，cPanel环境可能需要换成你的用户名

4. 旧缓存未清除 #

移到新目录后，之前的配置缓存可能保留了旧路径信息，导致加载异常。

解决方法：
终端执行缓存清除命令：

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

如果无法用终端，手动删除bootstrap/cache文件夹里的所有文件也可以。

这通常是因为错误处理机制还没加载就出问题了。比如index.php找不到vendor/autoload.php时，Laravel的错误处理类还没初始化，自然不会写入日志。你可以临时在index.php开头添加以下代码，强制显示错误：

ini_set('display_errors', 1);
ini_set('display_startup_errors', 1);
error_reporting(E_ALL);

排查完记得删掉这几行，避免暴露敏感信息。

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