onWorkerStart是在每个工作进程启动时自动触发的回调函数,用于初始化数据库连接、加载配置、注册全局对象等操作。每个Worker进程仅执行一次,适用于常驻内存的长期设置,如连接MySQL/Redis、复用配置、注册定时任务等。不同Worker间数据隔离,需独立初始化。注意事项包括避免阻塞操作、不启动额外服务、防止未捕获异常,以及在进程重启时会重新触发。合理使用可提升性能与稳定性,遵循“一次初始化、长期复用”原则。

Swoole的onWorkerStart回调**是在每个工作进程(Worker)启动时自动触发的事件回调函数**。它的主要作用是为Worker进程做初始化操作,比如建立数据库连接、加载配置、注册全局对象等。
初始化Worker进程
当Swoole服务器启动后,主进程会根据配置(如worker_num)创建多个Worker进程。每个Worker进程在正式处理请求前,都会执行一次onWorkerStart回调。这个时机非常适合进行单次初始化操作。
- 每个Worker进程只调用一次该回调
- 不同Worker之间的数据不共享,需各自初始化
常见使用场景
由于Worker进程是常驻内存的,可以在onWorkerStart中完成一些只需执行一次但长期有效的设置。
- 连接数据库:如MySQL、Redis,在这里创建连接可避免每次请求重复连接
- 加载配置文件:将配置读入内存,供后续请求复用
- 注册全局对象或类:如DI容器、日志实例等
- 定时任务注册:配合Swoole\Timer在特定Worker中添加周期性任务
注意事项
虽然onWorkerStart很实用,但使用时需要注意以下几点:
- 不能在这里执行阻塞操作(除非是Task进程)
- 不要在此处启动另一个服务或监听端口
- 避免在回调中抛出未捕获异常,可能导致Worker退出
- 如果使用了reload机制,重启Worker时也会再次触发此回调
基本上就这些。合理利用onWorkerStart能提升Swoole应用的性能和稳定性,关键是把好“一次初始化、长期复用”这个原则。










