如何排查ubuntu上thinkphp的错误日志

Ubuntu 上 ThinkPHP 错误日志排查步骤

一 定位日志位置与权限

• 框架日志默认位于项目根目录的 runtime/log/，常见结构为 runtime/log/年/月/日.log 或 runtime/log/年_月/日.log。若目录不存在或为空，优先检查 runtime 目录及子目录对 Web 服务运行用户（如 www-data） 是否可写。命令行示例：
  • 查看是否存在日志文件：ls -l runtime/log
  • 实时查看当天日志：tail -f runtime/log/$(date +%Y_%m/%d.log)
  • 如项目自定义了日志路径，可在 config/log.php 的 channels.file.path 找到实际目录。生产环境务必避免通过 Web 直接访问 runtime 目录。

二 配置日志级别与输出方式

• 建议至少开启 error 级别，必要时增加 warning/info/sql 便于定位。示例（config/log.php）：
  • 设置记录级别：‘level’ => [‘error’,‘warning’,‘info’,‘sql’]
  • 将不同级别分离到独立文件：‘apart_level’ => [‘error’,‘sql’]
  • 自定义日志目录：‘channels’ => [‘file’ => [‘path’ => app()-> getRootPath().‘logs/’]]
• 开发阶段可开启调试模式，便于页面直接输出错误与调用堆栈：在 config/app.php 设置 ‘app_debug’ => true；生产环境请关闭，避免泄露敏感信息。

三 查看与过滤日志的高效命令

• 实时跟踪最新错误：tail -f runtime/log/2025/11/01.log
• 按关键字过滤（如数据库连接失败）：grep -n “[error]” runtime/log/**/*.log
• 查看某一天的日志：cat runtime/log/2025_11/01.log
• 如需框架自带的日志命令（部分版本支持）：php think log
• 结合时间、级别、IP、URL 等字段进行检索，可快速定位到具体请求与代码位置。

四 无法写入或找不到日志时的系统层面排查

• 查看 PHP-FPM/Apache/Nginx 错误日志，确认是否因权限或语法错误导致应用未能写入日志：
  • Apache：/var/log/apache2/error.log
  • Nginx：/var/log/nginx/error.log
  • PHP-FPM：/var/log/php-fpm.log 或 /var/log/php/版本-fpm.log
• 检查 php.ini：确保 log_errors = On、设置合适的 error_log 路径，并确认 error_reporting 包含需要记录的错误级别；修改后重启服务：
  • 重启 Apache：sudo systemctl restart apache2
  • 重启 Nginx：sudo systemctl restart nginx
  • 重启 PHP-FPM：sudo systemctl restart php7.x-fpm
• 修复目录权限（示例）：chown -R www-data:www-data /path/to/project/runtime；必要时调整日志目录到 /var/log/yourproject/ 并确保运行用户可写。

五 常见错误与快速定位示例

• 数据库连接失败：日志中通常包含 SQLSTATE 与 Access denied 等关键字，堆栈会指向 think\db\Connection 的 connect/query 调用位置，按堆栈文件与行号修复账号、密码或主机配置。
• 数据表不存在：日志会出现 Base table not found 等信息，结合堆栈定位到执行查询的模型或控制器，检查迁移/建表是否执行。
• 生产环境页面空白或只显示简单错误：先临时开启 ‘app_debug’ => true 获取详细错误；同时检查 runtime 目录权限与 PHP 错误日志 是否有致命错误（如类未找到、语法错误）。修复后记得关闭调试模式。

声明：本文内容由网友自发贡献，本站不承担相应法律责任。对本内容有异议或投诉，请联系2913721942#qq.com核实处理，我们将尽快回复您，谢谢合作！