Debian如何调试Laravel错误

在 Debian 上调试 Laravel 错误，通常可以从 环境配置、日志、异常信息、PHP 配置、服务器配置 几个方面入手。下面按常见场景给你一份实用排查指南。

一、确认 Laravel 运行环境

1. 查看 Laravel 版本

php artisan --version

2. 确认运行模式

php artisan env

常见环境：

• local（开发，推荐开启调试）
• production（生产，调试信息应关闭）

二、开启 Laravel 调试模式（最重要）

1. 修改 .env

APP_ENV=local
APP_DEBUG=true

2. 清理配置缓存

php artisan config:clear
php artisan cache:clear

⚠️ 生产环境不要开启 APP_DEBUG=true

三、查看 Laravel 错误日志（最常用）

1. 查看日志文件

tail -f storage/logs/laravel.log

常见错误：

• SQL 错误
• 路由错误
• 中间件异常
• 权限问题

2. 日志权限问题（Debian 常见）

sudo chown -R www-data:www-data storage
sudo chmod -R 775 storage

如果你用 php artisan serve：

sudo chown -R $USER:$USER storage

四、PHP 错误调试（Debian 特有）

1. 查看 PHP 错误日志

tail -f /var/log/php8.2-fpm.log
# 或
tail -f /var/log/apache2/error.log

2. 开启 PHP 错误显示（开发环境）

编辑：

/etc/php/8.2/fpm/php.ini
# 或
/etc/php/8.2/cli/php.ini

设置：

display_errors = On
error_reporting = E_ALL
log_errors = On

重启 PHP-FPM：

sudo systemctl restart php8.2-fpm

五、Web 服务器错误（Nginx / Apache）

Nginx 常见错误

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

常见原因：

• root 路径错误
• index index.php 没配置
• PHP-FPM 未运行

Apache

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

六、Laravel 常见错误及排查

1. 500 错误但无页面提示

✅ 检查：

storage/logs/laravel.log

2. 路由 404

php artisan route:list

3. 数据库错误

php artisan migrate

检查 .env：

DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=xxx
DB_USERNAME=xxx
DB_PASSWORD=xxx

七、使用 Laravel 自带调试工具

1. dd() / dump()

dd($data);
dump($data);

2. 查看异常页面

访问错误页面时，Laravel 会显示：

• 异常类型
• 出错文件
• 堆栈信息

八、Debian 常见权限问题速查

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

九、快速排查流程（推荐）

1. 打开 APP_DEBUG=true
2. 访问页面
3. 看 storage/logs/laravel.log
4. 看 PHP / Nginx / Apache 日志
5. 检查权限

如果你愿意，可以把 具体错误信息 / 页面提示 / 日志内容 贴出来，我可以直接帮你定位是哪一类问题（PHP、Laravel、权限、数据库、服务器）。