Workerman生产环境需结构化日志：设绝对路径日志文件并赋权；捕获PHP错误至同一文件；用JSON记录含trace的完整上下文；通过专用日志进程或截断超长日志避免交织错乱。
Workerman服务在生产环境运行时突然中断或行为异常，必须能回溯到精确的上下文和完整调用链，仅靠终端输出或零散echo根本无法定位问题根源。
让Worker::log()写进指定文件
第一步：在start.php最开头（Worker启动前）设置绝对路径日志文件：
【Worker::$logFile必须是绝对路径，且PHP进程有写权限】
第二步：执行命令创建日志目录并赋权（以www-data用户为例）：
mkdir -p /var/log/workerman && chown www-data:www-data /var/log/workerman
第三步：确认PHP进程能真实写入——直接执行php start.php start -d后，立刻检查/var/log/workerman/app.log是否生成且有内容。若为空，说明目录权限不对或路径不存在，别等故障发生才排查。
捕获PHP原生错误进同一文件
方法一：修改CLI模式下的php.ini（不是Web服务器用的那个）
找到cli php.ini位置：php --ini → 编辑对应文件 → 设置log_errors = On → error_log = /var/log/workerman/app.log
方法二：代码中强制覆盖（适用于无法改php.ini的容器环境）
在start.php顶部加：ini_set('log_errors', '1'); ini_set('error_log', '/var/log/workerman/app.log');
【注意：两种方法不能同时启用，否则日志会重复写入两遍】
记录结构化、可解析的完整上下文
不要用Worker::log("用户登录失败")这种模糊语句。改成：
Worker::log(json_encode([
'level' => 'error',
'action' => 'login',
'user_id' => $uid ?: null,
'ip' => $_SERVER['REMOTE_ADDR'] ?? $connection->getRemoteIp(),
'trace' => debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 5),
'time' => date('Y-m-d H:i:s')], JSON_UNESCAPED_UNICODE));
这一步操作起来很简单，直接把上面代码复制进你的onMessage回调里就行。关键在于trace字段只取5层，避免日志爆炸；JSON_UNESCAPED_UNICODE保证中文不转义，grep时能直接搜“密码错误”而不是“\u5bc6\u7801”。
避免多进程写日志交织错乱
方法一：用专用日志进程（推荐生产环境）
起一个独立的LogWorker监听Unix Socket，所有业务Worker通过stream_socket_client('unix:///tmp/log.sock')发消息过去，由它串行写入文件。这样彻底规避内核write原子性边界（≤4096字节）失效风险。
方法二：强制截断超长日志
封装一个safe_log函数：
function safe_log($msg) { $msg = is_string($msg) ? $msg : json_encode($msg); Worker::log(substr($msg, 0, 3000)); }
这一步必须做——var_dump($hugeArray)或未处理的Exception堆栈动辄上万字符，一旦突破4KB，tail看到的日志就是半截JSON或两行粘连，根本没法分析。
