linux laravel为何白屏

linux

小樊

2026-09-22 10:51:36

栏目: 智能运维

在 Linux 上运行 Laravel 出现白屏（Blank Page / White Screen），通常不是“没内容”，而是错误被隐藏或进程直接崩溃。下面按「最常见 → 不常见」给你系统排查思路。

一、先看错误（最重要）

1️⃣ 打开调试模式

编辑 .env：

APP_DEBUG=true
APP_ENV=local

然后清缓存：

php artisan config:clear
php artisan cache:clear

✅ 白屏变报错，就成功一半。

2️⃣ 看 PHP / Web 服务错误日志

Nginx + PHP-FPM

tail -f /var/log/nginx/error.log
tail -f /var/log/php8.x-fpm.log

Apache

tail -f /var/log/apache2/error.log

常见错误：

Allowed memory size exhausted
Class not found
PHP Fatal error

二、Linux 权限问题（最常见）

storage / bootstrap 没写权限

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

www-data 可能是 nginx / apache 用户

三、Laravel 自身问题

1️⃣ 没生成 key

php artisan key:generate

2️⃣ 没装依赖

composer install

3️⃣ 缓存炸了

php artisan optimize:clear

四、PHP 版本 / 扩展问题

检查 PHP 版本

php -v

Laravel 版本对照：

Laravel 10 → PHP 8.1+
Laravel 11 → PHP 8.2+

缺扩展

常见必装：

php-mbstring
php-xml
php-curl
php-zip
php-bcmath
php-gd

五、Nginx / Apache 配置错误

Nginx 白屏常见原因

root 指向错误：

root /var/www/laravel/public;

index 必须有：

index index.php;

重写规则：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

六、内存耗尽（很隐蔽）

php -i | grep memory_limit

临时解决：

php -d memory_limit=512M artisan serve

七、最快速定位方式（强烈推荐）

php artisan serve

如果 artisan serve 正常，说明： ✅ Laravel 没问题
❌ Nginx / Apache / 权限有问题

八、你可以直接告诉我这些，我能精准定位

Linux 发行版（Ubuntu / CentOS）
Web 服务（Nginx / Apache）
Laravel 版本
PHP 版本
白屏时日志内容（如果有）

我可以一步一步帮你修到不白屏。