通过配置 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()，并逐层回溯至入口文件——无需猜测，直接定位问题代码行。
立即学习“PHP免费学习笔记（深入）”；
? 进阶建议
- 渐进式调优：初始设为 5s，确认无误后再逐步降至 2s 或 1s，避免日志爆炸；
- 结合其他工具：慢日志定位“哪里慢”，再配合 Xdebug（开发环境）或 Blackfire（生产）深入分析函数耗时；
- 警惕隐式阻塞：除 sleep() 外，还需关注 stream_socket_client()（无超时）、curl_exec()、mysqli_query() 等可能长期挂起的操作。
启用 slowlog 是 PHP 性能可观测性的基石能力——它不修改业务代码、不增加运行开销（仅超时时记录），却能在问题发生时提供决定性线索。与其在千行代码中“盲搜” sleep，不如让 PHP-FPM 主动为你标记出每一处拖慢用户体验的阻塞点。
