debian中laravel如何开启调试

在 Debian 系统中，Laravel 开启调试（Debug）主要是通过 环境变量 和 日志配置 来完成。下面按常见场景说明。

一、最常用方式（推荐）

1. 修改 .env 文件

在项目根目录找到 .env：

APP_DEBUG=true
APP_ENV=local

✅ 开启后：

• 页面会显示详细错误
• 异常堆栈可见
• 方便本地开发

⚠️ 生产环境一定要设为：

APP_DEBUG=false

2. 清除配置缓存（非常重要）

Debian 上常因缓存导致不生效：

php artisan config:clear
php artisan cache:clear

如果之前运行过：

php artisan config:cache

必须 config:clear 才能生效。

二、确认 config/app.php

一般不用改，但确认一下：

'debug' => env('APP_DEBUG', false),

三、Web 服务器权限问题（Debian 常见）

1. 存储目录权限

调试依赖日志：

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

或者你用当前用户运行 PHP：

sudo chown -R $USER:www-data storage

四、查看错误日志（调试利器）

日志位置

storage/logs/laravel.log

实时查看：

tail -f storage/logs/laravel.log

五、使用 Laravel Debugbar（强烈推荐）

安装

composer require barryvdh/laravel-debugbar --dev

发布配置（可选）

php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"

浏览器底部会出现调试面板（SQL、请求、日志等）。

六、Nginx / Apache 注意点

Nginx

确保 PHP 错误能显示：

fastcgi_param APP_DEBUG true;

或在 .env 中设置即可，一般不需要改 Nginx。

七、生产环境安全提醒

❌ 不要在生产开 APP_DEBUG=true
✅ 用日志 + Sentry / Flare 做错误监控

如果你愿意，可以告诉我：

• Laravel 版本
• Debian 版本
• 是本地还是服务器
• 用 Nginx 还是 Apache

我可以给你更精确的配置方案。