ThinkPHP在Linux上的错误日志分析

定位思路与日志来源

• 在 Linux 上排查 ThinkPHP 错误，优先同时查看两类日志：
  1. Web 服务器错误日志（如 Nginx：/var/log/nginx/error.log，Apache：/var/log/apache2/error.log 或 httpd/error_log），用于发现 500、权限、重写、FastCGI 等网关层问题；
  2. 应用日志（ThinkPHP 5 默认在 runtime/log/ 目录），用于定位业务异常、SQL、模板、路径等。
• 快速查看应用日志：
  • 实时跟踪：tail -f /path/to/project/runtime/log/*.log
  • 按级别筛选：grep -E 'ERROR|Exception' /path/to/project/runtime/log/*.log
• 临时开启调试有助于页面直接输出错误细节（上线环境慎用）：在配置中设置 ‘app_debug’ => true 或相应环境的调试开关，便于快速定位。

常见错误模式与排查要点

高效排查命令清单

• 实时查看应用日志：tail -f /var/www/your-app/runtime/log/*.log | egrep -i 'error|exception|fatal'
• 查看最近 Nginx 错误：tail -n50 /var/log/nginx/error.log | sed 's/\\n/ /g'
• 检查目录权限与属主：ls -ld /var/www/your-app/runtime /var/www/your-app/runtime/log
• 查找 PHP 致命错误：grep -R "PHP Fatal error" /var/log/php-fpm* /var/log/nginx/ 2>/dev/null
• 检查函数是否被禁用：php -i | grep disable_functions
• 验证重写规则是否生效（Nginx）：curl -I https://your-domain/non-existent-path

配置与预防建议

• 运行环境：确保 runtime 及子目录对 **Web 服务用户（如 www-data、nginx）**可写；上线前关闭调试模式，避免泄露敏感信息。
• 日志策略：在配置中合理设置日志级别与路径，例如仅记录 error 级别到文件：
  • 示例（ThinkPHP 5）：
    • ‘log’ => [ ‘level’ => [‘error’], ‘type’ => ‘File’, ‘path’ => ‘…/runtime/log/’ ]
• 数据库：避免长连接“僵死”，开启 PDO::ATTR_PERSISTENT => false 或在连接前检测/重连；根据业务调整 wait_timeout 与连接池策略。
• 安全与兼容：谨慎使用 open_basedir；上线前在测试环境验证 disable_functions 是否影响框架/依赖函数；Nginx 站点务必配置正确的重写规则将请求导向 index.php。