debian下laravel报错怎么办

在 Debian 下运行 Laravel 报错，第一步永远是看错误信息和日志，不能盲猜。下面给你一套「通用排查流程 + 常见报错速查表」，基本能解决 90% 的问题。

一、先确认“报错在哪里”

1️⃣ 页面报错

开发环境：APP_DEBUG=true
看页面红字（Laravel / Symfony 错误）

2️⃣ 日志文件（最重要）

storage/logs/laravel.log

tail -100 storage/logs/laravel.log

3️⃣ Web 服务器错误

Nginx：/var/log/nginx/error.log
Apache：/var/log/apache2/error.log

二、Debian 下 Laravel 最常见报错 & 解决

✅ 1. Permission denied（最常见）

报错示例

The stream or file "/var/www/laravel/storage/logs/laravel.log" could not be opened

解决

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

✅ 2. PHP 版本太低

报错

Your requirements could not be resolved

或

Composer detected issues in your platform

查看版本

php -v

Debian 安装 PHP 8.1/8.2

sudo apt install php8.2 php8.2-cli php8.2-fpm php8.2-mysql php8.2-mbstring php8.2-xml php8.2-curl

✅ 3. 缺少 PHP 扩展

常见缺失

mbstring
xml
curl
gd
zip
bcmath

安装

sudo apt install php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip php8.2-bcmath

重启：

sudo systemctl restart php8.2-fpm

✅ 4. Composer 报错

composer install

常见问题：

没装 composer
权限问题

重装 vendor

rm -rf vendor
composer install

✅ 5. .env 没配置

cp .env.example .env
php artisan key:generate

✅ 6. Nginx 配置错误（403 / 404）

正确 root

root /var/www/laravel/public;

重写规则

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

✅ 7. Storage 链接问题

php artisan storage:link

三、快速自检命令（建议保存）

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

四、你可以这样给我信息，我精准帮你

请把以下信息贴出来：

完整报错信息
Debian 版本（cat /etc/os-release）
PHP 版本
Web 服务（Nginx / Apache）
storage/logs/laravel.log 报错片段

我可以直接告诉你哪一行错了、怎么改。