怎样解决Debian的Laravel报错

解决 Debian 上 Laravel 报错，通常可以按**“先定位错误 → 再按类别解决”的思路来。下面我给你一个实用排查清单**，覆盖最常见的情况。

一、先确认报错信息（最关键）

1️⃣ 查看 Laravel 日志

tail -f storage/logs/laravel.log

2️⃣ 打开调试模式（开发环境）

APP_DEBUG=true

⚠️ 生产环境不要开启

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

1️⃣ PHP 版本或扩展缺失（最常见）

报错示例

PHP Fatal error: Class 'XXX' not found

或

Your requirements could not be resolved to an installable set of packages.

解决方案

安装 PHP 扩展（Debian 常见）

sudo apt update
sudo apt install -y \
php php-cli php-fpm \
php-mysql php-xml php-mbstring \
php-curl php-zip php-tokenizer \
php-bcmath php-gd

Laravel 10+ 需要 PHP ≥ 8.1

查看 PHP 版本：

php -v

2️⃣ Composer 依赖问题

报错示例

Class not found

Script @php artisan package:discover handling the post-autoload-dump event returned with error 255

解决方案

composer install --no-dev
composer dump-autoload

如果是版本冲突：

composer update

3️⃣ 权限问题（Debian 特有高发）

报错示例

The stream or file could not be opened

Permission denied

解决方案

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

如果你用 php artisan serve，当前用户也要有权限

4️⃣ 数据库报错

报错示例

SQLSTATE[HY000] [2002] No such file or directory

原因

Debian 默认 MySQL socket 路径不同

解决方案

修改 .env

DB_HOST=127.0.0.1
DB_PORT=3306

或确认 socket：

mysql -u root -p

5️⃣ Nginx / Apache 配置错误

Nginx 示例（Laravel 推荐）

server {
    listen 80;
    server_name your_domain;
    root /var/www/laravel/public;

    index index.php;

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

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/run/php/php-fpm.sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

然后：

sudo systemctl restart nginx
sudo systemctl restart php-fpm

6️⃣ storage / bootstrap 没写权限

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

7️⃣ 系统时区 / locale 报错（Debian 常见）

报错

PHP Warning: date()

解决方案

sudo dpkg-reconfigure locales
sudo apt install locales

PHP：

date.timezone = Asia/Shanghai

三、快速自检命令（推荐）

php -v
composer -V
php artisan --version
systemctl status nginx
systemctl status mysql

四、如果你愿意，我可以更精确帮你

你可以直接把 完整报错信息 发给我，例如：

• laravel.log 内容
• 终端报错
• 浏览器 500 页面
• Debian 版本（11 / 12）

我可以逐行帮你定位并给出精确命令 ✅