温馨提示×

laravel在centos怎么调试错误

小樊
43
2026-10-17 11:34:31
栏目: 智能运维

在 CentOS 上调试 Laravel 错误,通常可以从日志、配置、运行环境、调试工具几个方面入手。下面按实用顺序说明。


一、开启 Laravel 错误显示(最基础)

1. 修改 .env

APP_DEBUG=true
APP_ENV=local

然后清缓存:

php artisan config:clear
php artisan cache:clear

生产环境不建议长期开启 APP_DEBUG=true


二、查看 Laravel 日志(最重要)

Laravel 默认日志位置:

storage/logs/laravel.log

实时查看:

tail -f storage/logs/laravel.log

常见错误类型:

  • SQL 错误
  • 路由不存在
  • 权限问题(storage / bootstrap/cache)
  • 第三方服务异常

三、查看 PHP 错误日志(CentOS 层)

1. 找到 php.ini

php --ini

2. 查看错误日志路径

log_errors = On
error_log = /var/log/php/php_errors.log

查看:

tail -f /var/log/php/php_errors.log

如果没有:

sudo mkdir -p /var/log/php
sudo chown apache:apache /var/log/php

四、权限问题(CentOS 常见坑)

Laravel 需要写权限:

sudo chown -R nginx:nginx /var/www/your_project
# 或 apache:apache

sudo chmod -R 755 storage bootstrap/cache
sudo chmod -R 777 storage bootstrap/cache # 临时调试

五、Web 服务器错误(Nginx / Apache)

Nginx

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

常见:

  • 500 → PHP / Laravel 错误
  • 404 → rewrite 配置问题

Nginx 示例:

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

六、使用 Laravel 调试工具

1. dd() / dump()

dd($request->all());

2. Laravel Telescope(推荐)

composer require laravel/telescope
php artisan telescope:install
php artisan migrate

访问:

/project/telescope

可看:

  • 请求
  • 异常
  • SQL
  • 队列

七、命令行调试

php artisan serve

或手动执行:

php artisan your:command

查看具体报错。


八、常见 CentOS + Laravel 错误速查

现象 原因
500 错误 APP_DEBUG=false
storage 不可写 权限问题
Class not found composer 未 autoload
SQL 报错 看 laravel.log
空白页 PHP 报错被关

如果你愿意,可以:

  • 贴出具体报错信息
  • 说明是 Nginx / Apache
  • 是否 本地还是服务器

我可以帮你精准定位。

0 踩