Laravel 在 CentOS 上的错误排查方法
一 快速定位路径
- 查看应用日志：在项目根目录执行 tail -f storage/logs/laravel.log，或运行 php artisan log:tail 实时查看最新错误与堆栈。
- 查看 PHP-FPM 日志：常见路径为 /var/log/php-fpm.log 或 /var/log/php7.x-fpm.log（按实际 PHP 版本）。
- 查看 Web 服务器错误日志：Nginx 通常为 /var/log/nginx/error.log；Apache 为 /var/log/httpd/error_log。
- 查看 Laravel 配置与缓存：核对 .env 关键项（如 APP_KEY、DB_*），必要时执行 php artisan config:clear、php artisan cache:clear、php artisan route:clear、php artisan view:clear。
二 环境与依赖检查
- PHP 版本：运行 php -v，确保满足项目所需版本（多数现代 Laravel 需 PHP ≥ 7.3；具体以项目为准）。
- 必要扩展：通过包管理器安装常用扩展，例如：sudo yum install php-common php-cli php-fpm php-json php-pdo php-mysqlnd php-zip php-gd php-mbstring php-curl php-xml php-pear php-bcmath。
- Composer 依赖：在项目根目录执行 composer install；若依赖异常，可先 composer clearcache 再安装。
- 应用密钥：若 APP_KEY 缺失，执行 php artisan key:generate。
三 权限与 SELinux
- 目录属主与权限：确保 storage 与 bootstrap/cache 可写，常见做法是将属主设为运行 Web 服务的用户（如 nginx 或 www-data），示例：sudo chown -R nginx:nginx /path/to/project；sudo chmod -R 755 /path/to/project/{storage,bootstrap/cache}。
- SELinux：若启用 SELinux 导致写入或访问被拒，可临时执行 sudo setenforce 0 验证；生产环境不建议长期关闭，应按需配置 SELinux 布尔值或上下文（如 httpd 读写权限）。
四 Web 服务器与路由配置
- 根目录与重写：确保 Web 根目录指向 public；Nginx 示例：root /path/to/project/public；location / { try_files $uri $uri/ /index.php?$query_string; }；location ~ .php$ { fastcgi_pass unix:/var/run/php-fpm/php-fpm.sock; include fastcgi_params; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; }。
- Apache：确认启用 mod_rewrite，且虚拟主机 DocumentRoot 指向 public，AllowOverride All。
- 常见症状：出现 404 多为重写未生效或根目录未指向 public；出现 “No input file specified” 多为 SCRIPT_FILENAME 或 PATH_INFO 配置不当。
五 数据库与缓存及常见修复
- 数据库连接：核对 .env 中 DB_CONNECTION、DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD；确保数据库服务运行且网络可达。
- 迁移与优化：按需执行 php artisan migrate；生产环境可 php artisan config:cache、php artisan route:cache，但修改配置后需 config:clear。
- 日志级别与轮转：在 .env 设置 LOG_LEVEL=debug 获取更详细日志；在 config/logging.php 使用 daily 通道并按需保留天数（如 days=14）。
- 内存不足：执行命令时临时提升内存，如 php -d memory_limit=256M …；或调整 php.ini 的 memory_limit。
- 500 错误速查清单：依次检查 laravel.log、php-fpm.log、Web 错误日志；核对 .env 与缓存；确认目录权限与 SELinux；验证数据库连通与迁移；复核 Nginx/Apache 配置与重写规则。