Cannot assign requested address 错误是因 Workerman 绑定的 IP 在本机不存在或不可用,如配置 192.168.10.100 但网卡未分配该地址;需用 ip addr show 验证 IP 是否存在于 up 状态网卡,且注意 Docker、云服务器等环境的网络特性。

Workerman 启动报 Cannot assign requested address 是绑定 IP 出了问题
这个错误不是端口被占,也不是权限不够,而是 Workerman 尝试绑定一个本机根本不存在或不可用的 IP 地址。比如配置里写了 'ip' => '192.168.10.100',但网卡实际没配这个地址,系统就直接拒绝绑定。
检查 $worker->listen() 的 IP 参数是否真实存在
Workerman 默认监听 0.0.0.0(所有接口),一旦显式指定 IP,就必须确保该 IP 是本机已激活的地址。常见错误包括:
- 写错内网 IP,比如把
172.16.0.5写成172.16.0.50 - 在 Docker 容器里绑宿主机 IP(如
192.168.1.100),容器网络根本看不到这个地址 - 用了
127.0.0.1却想让外部访问——它只响应本地回环,外部连不上也常触发同类报错(尤其配合防火墙时) - IPv6 地址写法不规范,比如漏了方括号:
[::1]不能简写为::1(某些系统会拒 bind)
验证方式:运行 ip addr show 或 ifconfig,确认你要绑定的 IP 确实在某张 up 状态的网卡上。
bind_to_ip 和 listen 的区别别搞混
Workerman 没有 bind_to_ip 这个配置项,这是常见误解来源。真正起作用的是 $worker->listen() 的第一个参数,例如:
$worker = new Worker('tcp://192.168.1.100:2345');
或者用数组形式指定:
$worker = new Worker('tcp://0.0.0.0:2345');
$worker->listen(); // 这里不传参,走默认
如果你在 Worker 构造之后又调用类似 $worker->address = '192.168.1.100:2345',这不会生效——Workerman 不读这个字段。
Docker 或云服务器环境要特别注意网络模式
在容器或某些云主机(如阿里云 ECS 启用了安全组+私网 NAT)里,127.0.0.1 和 0.0.0.0 表现可能反直觉:
- Docker 默认是 bridge 模式,容器内
127.0.0.1是它自己的 loopback,不是宿主机的;想被宿主机访问,必须 bind0.0.0.0 - 阿里云/腾讯云的“内网 IP”其实是虚拟网卡地址,得看
ip addr输出里是否带scope global,而不是只看控制台显示的 IP - 某些 OpenVZ 或 LXC 环境禁止非
0.0.0.0的 bind,会直接报这个错,只能改用0.0.0.0+ 防火墙控访问
最稳的做法:开发阶段先用 0.0.0.0 启起来,确认功能正常,再根据部署约束收紧 IP 绑定。
IP 绑定不是越具体越好,关键得和实际网络栈对得上。很多人卡在这里,是因为盯着端口和日志反复重启,却忘了先看一眼 ip addr 输出里有没有那个 IP。










