如何配置Swoole记录慢日志

很多人在使用 Swoole 的 HTTP 或 WebSocket 服务器时，都会遇到一个让人摸不着头脑的问题：明明请求卡住了，慢日志里却啥也没有。这其实不是 bug，而是 Swoole 的设计如此——它默认根本不记录慢日志。说白了，你连“慢”的标准都没告诉它，它自然不会主动去记。

为什么 swoole_http_server 不记录慢日志？

默认情况下，Swoole 的 swoole_http_server 或 swoole_websocket_server 完全不会自动记录慢请求——它连“慢”的定义都没有。所谓“慢日志”，是 Swoole 4.5.0+ 引入的可选功能，需显式开启并配置阈值，且仅对协程模式（enable_coroutine => true）下的 onRequest、onMessage 等回调生效。

常见的错误现象包括：slowlog 配置写了但日志文件始终是空的；用 strace 看到请求卡住了，但日志毫无记录；或者升级到 4.8.x 后依然不触发。这些问题的根源，基本可以归结为两点：要么没启用协程，要么阈值设得太高（比如直接设成了 10 秒）。

• 必须开启协程：启动前设置 enable_coroutine => true
• 阈值单位是毫秒，不是秒；建议从 100（100ms）开始调，线上可逐步收紧
• 日志路径需进程有写权限，且父目录必须存在（Swoole 不自动创建多级目录）

slowlog 和 slowlog_file 参数怎么配？

Swoole 提供两个核心配置项：slowlog 控制是否启用慢日志，slowlog_file 指定输出路径。它们只在 Server 实例化时生效，运行中无法动态修改。

来看一个示例配置片段（PHP）：

$server = new swoole_http_server('0.0.0.0', 9501);$server->set([    'enable_coroutine' => true,    'slowlog'          => true,    'slowlog_file'     => '/tmp/swoole_slow.log',    'slowlog_timeout'  => 100, // 单位：毫秒]);

• slowlog 是布尔值，设为 false 或未设置 = 关闭功能
• slowlog_file 路径若为相对路径（如 ./slow.log），会基于当前工作目录解析，不是项目根目录
• slowlog_timeout 是可选参数，默认 1000（1s），低于该值的请求不记

慢日志里到底记录了什么？

每条慢日志是一行纯文本，包含时间戳、协程 ID、耗时（ms）、当前执行的 PHP 文件与行号、以及调用栈顶层函数。例如：

[2024-06-12 14:22:35 @9876.0]  [DEBUG]  slow log: co_id=123, use_time=1245 ms, file=/app/app/Http/Controller/User.php, line=45, function=User::getProfile

注意：它不记录 HTTP 请求头、POST 数据或返回内容，也不捕获异常——只是告诉你是哪个协程、在哪卡了多久。如果卡在 curl_exec、pdo->query 或 Redis get 上，且这些操作未协程化（即用了同步阻塞扩展），日志里只会显示进入该函数的那一行，不会深入底层 C 函数。

• 若看到大量 function=swoole_mysql_query 或 function=curl_exec，说明你混用了同步客户端，应该换成 SwooleCoroutineMySQL 等协程版
• 协程 ID（co_id）可用于关联 coroutine::list() 中的上下文信息
• 日志行末没有换行符，多条日志会挤在同一行——确保你的查看工具支持长行折行

为什么日志写了但看不到堆栈？

当 slowlog 生效但日志中缺失 file/line/function 字段，大概率是 PHP 的 debug_backtrace 被禁用或截断了。Swoole 内部依赖它获取调用位置，而某些环境会限制其深度或禁用。

• 检查 php.ini 中是否设置了 zend.assertions = -1 或 assert.active = Off（虽然不直接相关，但部分旧版本 Swoole 会受 assert 影响）
• 确认未启用 OPcache 的“优化”模式（如 opcache.optimization_level=0xFFFFFFFF 可能干扰调试信息）
• 最稳妥的方式：在慢请求逻辑入口处手动打点，例如 Co::sleep(0.1) 前加 var_dump(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2))，验证能否正常获取

协程调度和 PHP 扩展兼容性仍是黑盒较多的部分，慢日志只是线索，不是根因诊断器。理解它的能力边界，才能正确用好它。