“worker has been populated”不是错误，而是workerman检测到重复加载worker实例时主动中止启动的保护机制；常见原因包括多次require/include worker文件、路径拼错导致重复加载、cli命令重复执行或与swoole等框架嵌套使用。
“Worker has been populated”是Workerman的启动保护机制
这个提示不是错误，而是Workerman在检测到重复加载Worker实例时主动中止启动的防御行为。它意味着你代码里多次执行了new Worker()或Worker::runAll()，导致同一个Worker对象被反复注册——这会引发连接混乱、内存泄漏甚至进程崩溃。
常见触发场景和对应检查点
以下情况最容易触发该提示：
- 在
start.php中多次require或include了定义Worker的文件（比如把new Worker()写在了一个被循环加载的配置文件里） - 使用了
require_once但路径拼错，导致实际加载了多个不同路径下的同名Worker定义文件 - 在CLI命令中误加了多余参数，例如运行
php start.php start start，造成脚本被重复执行 - 在Swoole或其它常驻进程框架中嵌套启用了Workerman（二者不兼容，会互相干扰生命周期）
如何快速定位重复加载点
在Worker初始化前加一句日志，就能暴露问题源头：
echo "Loading worker at: " . __FILE__ . ":" . __LINE__ . "\n";
$ws_worker = new Worker("websocket://0.0.0.0:2346");
然后启动服务，观察控制台是否输出多于一次。如果输出两次以上，说明你的Worker类被加载了多次。
另一个有效方式是检查get_included_files()结果，看哪些文件被重复包含：
var_dump(array_count_values(get_included_files()));
reusePort开启后仍报“Worker has been populated”？
这是个典型误区：reusePort解决的是Linux内核的“惊群”问题，和Worker重复注册完全无关。它只影响底层socket绑定行为，不会绕过Workerman自身的实例校验逻辑。如果你开了reusePort还看到这个提示，说明问题仍在PHP层——别往网络配置上找，回去查require链。
真正容易被忽略的是：Workerman的Worker::runAll()必须且只能调用一次，且必须放在所有Worker定义之后。任何提前调用、条件调用、或封装进函数再调用，都可能破坏这个顺序约束。
