日志未输出的主因是未配置swoole.log_file或权限不足、log_level过低（默认INFO）、协程异常未捕获；需设绝对路径并授权、调高log_level至WARNING/ERROR、注册onError及Coroutine::setExceptionHandler。
日志根本没输出？检查 swoole.log_file 和权限
默认情况下，Swoole 不会自动写日志到文件，swoole.log_file 必须显式配置，且路径需可写。常见错误是设成 /var/log/swoole.log 却忘了给运行用户（比如 www-data 或 nginx）写权限。
-
swoole.log_file路径必须是绝对路径，相对路径会被忽略 - 启动前用
touch /path/to/log && chown www-data:www-data /path/to/log验证写入能力 - 若用
cli启动，日志默认输出到终端；但daemonize => true后，不配log_file就等于“静默崩溃” - PHP 错误（如
Fatal error）不会进 Swoole 日志，得靠error_log或display_errors = Off+log_errors = On配合
日志级别太低，关键错误被过滤了
Swoole 默认日志级别是 SWOOLE_LOG_INFO，而连接超时、协程调度异常、onReceive 报错等往往只在 WARNING 或 ERROR 级别输出。不调高就等于关掉了报警灯。
- 启动时加配置：
'log_level' => SWOOLE_LOG_WARNING（或直接填4） -
SWOOLE_LOG_ERROR（值为5）能看到Connection reset by peer、recv() failed类网络底层错误 - 别在运行中动态改
log_level—— 它只在 Server 初始化阶段生效 - 注意：调太高（比如
SWOOLE_LOG_DEBUG）会产生巨量日志，压垮磁盘 IO，仅调试时临时启用
协程里出错没日志？因为没触发 onError 或没捕获异常
在 onReceive、onRequest 里抛出未捕获的 Exception，默认不会打到 Swoole 日志，也不会终止进程，而是静默丢弃——这是新手最懵的点。
- 必须手动注册
onError回调，并在里面写日志：$server->on('error', function ($server, $worker_id, $worker_pid, $exit_code, $signal) { error_log("Worker {$worker_id} exit: {$exit_code}, signal: {$signal}"); }); - 协程内异常（比如
Co::sleep(-1)）不会走onError，得用try/catch包住业务逻辑 -
set_exception_handler()对协程无效，它只管主线程；协程要用Swoole\Coroutine::setExceptionHandler() - 别依赖
echo或var_dump—— 协程里它们不输出到终端，也不进日志
tail -f 看不到实时日志？可能是缓冲或轮转干扰
日志写了但 tail -f 没反应，大概率是 PHP 的 output_buffering 或 Swoole 自身的 log 缓冲机制在起作用，也可能是日志轮转把文件句柄搞丢了。
- 确保
swoole.log_file所在目录没有被 logrotate 频繁重命名，否则 Swoole 还往旧 fd 写，新文件始终为空 - 加配置
'log_buffer_size' => 0关闭日志缓冲（默认是64K），适合调试 - PHP 层面确认
output_buffering = Off，避免error_log()被卡住 - 用
lsof -p $(pgrep php) | grep log查看进程是否还持有旧日志文件句柄
真正难排查的，往往是日志没开、级别不对、协程异常没兜底这三件事叠在一起。只要逐个确认这三点，90% 的“日志消失”问题就定位完了。
