swoole 4.x日志需显式配置：设log_file为绝对路径、log_level为warning/error，协程异常须在内部try-catch并记录cid与上下文，避免静默退出；未hook阻塞调用和连接泄漏是高频根因。
Swoole 4.x（如 4.6.7、4.8.x）虽已逐步被 5.x 取代，但在不少线上系统中仍在稳定运行。日志配置不当或错误排查路径不清晰，极易导致“服务没报错却行为异常”“协程静默退出”“定时器失效”等疑难问题。关键不是堆日志量，而是让日志能精准定位到协程上下文、IO 阶段和调度状态。
Swoole 6.1.1
下载
Swoole 6.1.1 是一个专为 PHP 设计的高性能事件驱动并发网络引擎。作为稳定版，它修复了编译时对 zlib 依赖的缺失及 curl 模块的内存安全风险。该版本支持协程、多线程与多进程架构，内置 TCP/HTTP/WebSocket 服务器，能够显著提升 PHP 在微服务、实时通信等场景下的执行效率与并发能力。
日志开关与核心配置项
Swoole 4 默认不输出详细运行时日志，需显式开启且注意作用域： - 主服务启动前设置全局日志级别：`Swoole\Runtime::setHookFlags(SWOOLE_HOOK_ALL);`
`Swoole\Error::$log_level = SWOOLE_LOG_DEBUG;`（仅影响 Swoole 内部错误，非 PHP 错误） - 在 `swoole_server` 或 `swoole_http_server` 实例化后，立即配置：
`$server->set([`
` 'log_file' => '/var/log/swoole/server.log',`
` 'log_level' => SWOOLE_LOG_WARNING, // 建议设为 WARNING 或 ERROR，DEBUG 仅调试期用`
` 'daemonize' => true,`
`]);` - 注意：`log_file` 必须是**进程有写权限的绝对路径**，且父目录需存在；若路径无效，Swoole 会静默降级为输出到 stderr（常被 systemd 或 supervisor 截断）
协程内异常为何“看不见”？
Swoole 4 协程中未捕获的异常不会终止进程，只结束当前协程——这正是日志缺失的主因： - 不要依赖 `try/catch` 包裹整个协程函数体，而应在每个可能出错的 I/O 调用后检查返回值或监听异常： ```php go(function () { $client = new Swoole\Coroutine\Http\Client('api.example.com', 443, true); if (!$client->get('/data')) { // 记录协程 ID + 错误码，比抛异常更可靠 \Swoole\Coroutine::printLog( 'http_client_failed', sprintf('cid=%d, errno=%d, msg=%s', \Swoole\Coroutine::getCid(), $client->errCode, $client->errMsg ) ); return; } }); ``` - 启用 `swoole.display_errors = On`（在 php.ini 中）可让 PHP 层错误透出，但仅对同步代码有效；协程内仍需主动记录三类高频错误的日志线索
- **Connection reset by peer / Broken pipe**：→ 查 `log_file` 中是否出现 `WARNING swReactorThread_onWrite (ERRNO 104): connection#X is closed`
→ 多数因客户端提前断连，或服务端 `send()` 时连接已失效；启用 `open_tcp_nodelay => true` 可减少小包延迟引发的误判 - **协程卡死 / 定时器不触发**：
→ 检查是否在协程中调用了未 Hook 的阻塞函数（如 `sleep()`、原生 `curl_exec()`、`file_get_contents`）
→ 运行 `lsof -p
→ 查 `log_file` 开头是否有 `FATAL` 级别日志，如 `Fatal error: Allowed memory size exhausted`
→ Swoole 4 默认不记录 OOM 前的内存快照，需配合 `memory_limit` 和 `ulimit -v` 双重限制，并开启 `enable_coroutine => true` 避免协程栈溢出
快速验证日志是否生效的命令
- 查看实际加载的配置：`php --ri swoole | grep "log_file\|log_level"` - 手动触发一条调试日志：
`php -r "Swoole\Error::log('test from cli', SWOOLE_LOG_DEBUG);" 2>/dev/null || echo "log not enabled"` - 检查进程打开的日志文件句柄：
`ls -l /proc/$(pgrep php)/fd/ | grep log`
Swoole 4 的日志机制本身轻量，但它的沉默往往意味着你漏掉了某个上下文切换点或权限细节。
