Swoole HTTP Server默认不记录慢日志,因该功能需显式启用协程(enable_coroutine => true)、设置slowlog => true、slowlog_timeout(单位毫秒)及可写slowlog_file路径,且仅对协程化回调生效。

为什么 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):
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版,它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构,内置 TCP/HTTP/WebSocket 服务器,能够显著提升 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,说明你混用了同步客户端,应切换为Swoole\Coroutine\MySQL等协程版 - 协程 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 扩展兼容性仍是黑盒较多的部分,慢日志只是线索,不是根因诊断器。

















