Workerman服务启动卡在初始化阶段通常因onWorkerStart内阻塞操作所致，需通过ps和strace定位IO阻塞，排查同步网络请求、文件路径权限及扩展级锁等问题，并用microtime打点精确测量各段耗时。
Workerman服务启动后长时间卡在初始化阶段，Worker进程迟迟不进入事件循环，客户端连接超时、日志无后续输出、ps显示进程状态为“starting”——这通常意味着onWorkerStart内有阻塞操作或资源竞争未释放。
确认是否真卡在onWorkerStart
执行ps aux --sort=-etime | grep WorkerMan，找出运行时间最短的worker进程（如刚启动几秒），记下其PID；再用strace -p PID -e trace=connect,openat,read,write,close -s 128 -T实时抓取系统调用，若持续看到connect(0x...)阻塞超5秒或openat(AT_FDCWD, "/path/to/config.php", ...)返回缓慢，基本锁定onWorkerStart内IO阻塞。
注意：【不要只看workerman.log末尾是否有“onWorkerStart finished”】，某些异常（如未捕获的致命错误、PHP扩展崩溃）会导致onWorkerStart中途退出但不打日志，进程静默挂起。
逐项排查高频阻塞点
方法一：检查同步网络请求
搜索所有onWorkerStart中出现的file_get_contents、curl_exec、Redis::connect、PDO::__construct调用——这些默认无超时，一旦目标服务不可达，会卡死整个进程。必须显式设置超时：curl_setopt($ch, CURLOPT_TIMEOUT_MS, 3000)、new Redis()->connect('127.0.0.1', 6379, 3)、PDO DSN追加;timeout=3。
方法二：验证文件/目录权限与路径有效性
检查onWorkerStart里所有require、include、file_exists、is_dir操作的目标路径：若路径含变量拼接（如__DIR__ . '/config/' . $env . '/app.php'），且$env为空或错拼，PHP会尝试打开不存在路径，触发大量stat系统调用，尤其在NFS或低配云盘上延迟可达数秒。
方法三：检测扩展级阻塞
若启用了opcache.validate_timestamps=0且opcache未预热，首次require大量文件时会触发全量编译；更隐蔽的是apcu_clear_cache()或apc_clear_cache('user')在onWorkerStart中被调用——APCu内部锁机制会导致多进程启动时串行等待，count=8的Worker可能排队等满8秒才陆续启动。
快速定位耗时代码段
第一步：在onWorkerStart开头插入$start = microtime(true);，结尾加Worker::log('onWorkerStart cost: ' . (microtime(true) - $start) . 's');，重启服务后查workerman.log。
第二步：若耗时>1s，在疑似慢代码块前后各加一行Worker::log('step X start at ' . microtime(true));，缩小范围到具体函数或语句。
第三步：对第三方SDK初始化（如Elasticsearch\Client、AlibabaCloud\Client）启用debug模式并捕获底层HTTP Client耗时，很多SDK默认重试3次+指数退避，单次失败就拖满15秒。
这一步操作起来很简单，直接把日志行加进去就行，不需要改任何业务逻辑。
