白屏主因是php错误被静默屏蔽或类未加载，须依次检查display_errors是否开启、vendor/autoload.php是否有效、.env配置是否合法，并清空config/cache/view缓存。
白屏通常不是页面真“空了”，而是 PHP 报错被静默吞掉，或关键类根本没加载成功。Laragon 环境下，得从 PHP 错误、Composer 加载、.env 配置三处连环排查。
确认 PHP 是否真的在报错
默认情况下，Laragon 的 Apache/PHP 会关闭错误显示（display_errors=Off），导致致命错误直接白屏。必须手动打开：
- 点击 Laragon 主界面右上角 Menu → PHP → php.ini，找到
display_errors = Off这一行，改成display_errors = On - 再找
error_reporting = E_ALL & ~E_DEPRECATED & ~E_STRICT，确保它没被注释，且覆盖所有错误级别 - 保存后，点击 Laragon 托盘图标 → Restart All，让配置生效
查 Laravel 启动失败的真实原因
白屏最常见于 Class 'Illuminate\Foundation\Application' not found，这说明 vendor/autoload.php 没执行，根源往往是 composer install 没跑完、或 vendor 目录损坏：
- 进项目目录，用 Laragon 内置终端（托盘右键 → Terminal）执行：
php -v和composer -V，确认 PHP 和 Composer 可用 - 运行
composer install --no-scripts强制重装依赖（跳过 post-autoload-dump 等可能出错的脚本） - 再手动执行自动加载映射：
composer dump-autoload - 最后检查
vendor/autoload.php是否真实存在且可读
定位 .env 或缓存引发的静默崩溃
哪怕只改了一个字母，比如 APP_KEY= 后面多加了个空格，或 DB_HOST 写成 localhost:（带冒号），Laravel 在启动时就可能提前退出，不报错也不渲染 —— 因为它卡在 config/app.php 解析阶段。
- 先确认
.env文件存在，且权限正常（Windows 下一般没问题，但别用记事本另存为导致 BOM 头） - 运行
php artisan tinker，如果进不去，说明基础配置已崩；能进去就逐条试：config('app.name')、config('database.connections.mysql.host')，看哪一项返回null或报错 - 清掉所有缓存再试：
php artisan config:clear && php artisan cache:clear && php artisan view:clear
直接看 Laragon 的错误日志文件
Laragon 把所有服务日志都集中放在一个地方，比翻 Apache 或 PHP 日志更直接：
- 打开目录：
C:\laragon\logs\ - 重点关注三个文件：
apache_error.log（Apache 启动/重写错误）、php_error.log（PHP 致命错误和警告）、mysql_error.log（数据库连接失败等） - 每次刷新白屏页面后，立刻打开
php_error.log，末尾几行通常就是崩溃瞬间的堆栈
