PHP慢查询定位与阻塞排查技巧

一分耕耘，一分收获！既然都打开这篇《PHP脚本慢查询定位与阻塞排查方法》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

通过配置 PHP-FPM 的慢日志（slowlog），可自动捕获并记录执行超时的请求堆栈，精准定位 `sleep()`、数据库阻塞、未优化循环等隐藏性能瓶颈。

在生产环境中，PHP 脚本偶发性卡顿（如页面加载长达数秒）往往难以复现和追踪——尤其是当问题源于一段被遗忘的 sleep(5)、未加超时的 file_get_contents()、或死锁的数据库查询时。手动全局搜索关键词（如 sleep、usleep、time_nanosleep）效率低且易遗漏，而启用 PHP 内置的慢请求日志（slowlog） 是最直接、可靠且无侵入性的诊断手段。

✅ 启用 PHP-FPM 慢日志的核心配置

在对应 PHP-FPM Pool 配置文件中（如 /etc/php/8.2/fpm/pool.d/www.conf），添加或修改以下两项：

; 指定慢日志文件路径（确保目录存在且 PHP-FPM 进程有写入权限）
slowlog = /var/log/php-fpm/slow.log

; 触发慢日志记录的执行阈值（建议从 3s 开始，按需调低）
request_slowlog_timeout = 3s

⚠️ 注意事项：

• slowlog 文件路径的父目录（如 /var/log/php-fpm/）必须由 www-data（或对应 FPM 用户）可写；
• 修改后需重启 PHP-FPM：sudo systemctl reload php8.2-fpm（版本号请按实际调整）；
• 此功能仅对通过 PHP-FPM 处理的 Web 请求生效（不适用于 CLI 模式）。

? 日志示例：一眼识别“罪魁祸首”

当某请求执行超过 3 秒，slow.log 中将生成类似如下堆栈：

[12-Oct-2024 14:22:36]  [pool www] pid 12345
script_filename = /srv/www/example.com/public/index.php
[0x00007f8b1c0a1234] sleep() /srv/www/example.com/lib/utils.php:42
[0x00007f8b1c0a1256] process_data() /srv/www/example.com/app/controller.php:88
[0x00007f8b1c0a1278] handle_request() /srv/www/example.com/public/index.php:25

该输出清晰显示：请求在 utils.php 第 42 行调用了 sleep()，并逐层回溯至入口文件——无需猜测，直接定位问题代码行。

? 进阶建议

• 渐进式调优：初始设为 5s，确认无误后再逐步降至 2s 或 1s，避免日志爆炸；
• 结合其他工具：慢日志定位“哪里慢”，再配合 Xdebug（开发环境）或 Blackfire（生产）深入分析函数耗时；
• 警惕隐式阻塞：除 sleep() 外，还需关注 stream_socket_client()（无超时）、curl_exec()、mysqli_query() 等可能长期挂起的操作。

启用 slowlog 是 PHP 性能可观测性的基石能力——它不修改业务代码、不增加运行开销（仅超时时记录），却能在问题发生时提供决定性线索。与其在千行代码中“盲搜” sleep，不如让 PHP-FPM 主动为你标记出每一处拖慢用户体验的阻塞点。

今天关于《PHP慢查询定位与阻塞排查技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！