workerman-jsonrpc客户端通过rpcclient::config()传入含多个tcp://ip:端口的数组实现多服务器调用,服务端须监听0.0.0.0或具体内网ip,无内置服务发现与健康检查,需手动或借助consul等外部组件管理节点上下线。

Workerman 本身不内置服务发现或跨机地址自动同步机制,多台服务器间做内部 RPC 通信,必须手动管理服务端地址列表或引入外部注册中心——这是最关键的判断,绕不开。
客户端如何指定多个远程服务器地址
Workerman-JsonRpc 的 RpcClient::config() 接收的是一个数组,不是单个地址。只要每台服务器都运行着同一个服务类(如 User),你就可以把它们的 IP + 端口全部写进去:
- 地址格式必须是
tcp://192.168.1.10:2015这样的完整协议+IP+端口,不能只写 IP 或只写端口 - 数组里顺序不影响调用逻辑,但默认负载策略是轮询(按索引循环取),没有健康检查,挂掉的节点会直接导致请求失败
- 如果某台机器防火墙没开 2015 端口、SELinux 拦截、或
iptables限制了连接,RpcClient会卡在 connect 阶段,超时时间由 PHP 的default_socket_timeout决定(通常 60 秒)
示例配置:
$address_array = [
'tcp://10.0.1.5:2015',
'tcp://10.0.1.6:2015',
'tcp://10.0.1.7:2015'
];
RpcClient::config($address_array);
服务端监听地址不能写 127.0.0.1
常见错误是服务端启动时监听 tcp://127.0.0.1:2015,结果其他机器连不上。Workerman 默认只绑定本地回环,必须显式改成 0.0.0.0 或具体内网 IP:
一款AI数据处理工具,主要用于用于查询 Massive 市场数据端点的 Bash CLI 封装和 OpenClaw 技能,适用于 Codex 或 OpenClaw 代理从 shell 调用,适合需要提升相关任务效率的用户。
- 正确写法:
$server->listen('tcp://0.0.0.0:2015')或$server->listen('tcp://10.0.1.5:2015') - 监听
0.0.0.0时,确保服务器防火墙放行对应端口(例如ufw allow 2015) - 不要在生产环境监听
0.0.0.0并暴露到公网,RPC 接口无认证机制,等同于裸奔
没有服务发现时,客户端怎么感知节点上下线
Workerman-JsonRpc 客户端原生不支持心跳探测或自动剔除失效节点。一旦某台服务端宕机,下次轮到它时请求就会失败,且不会自动跳过:
- 最简方案:自己封装一层地址池,每次调用前用
fsockopen()尝试连接,超时则临时移出列表(注意并发下需加锁或用apcu缓存状态) - 更稳方案:接入 Consul 或 Nacos,客户端启动时拉取服务列表,并监听变更事件,动态更新
$address_array - 别依赖
filemtime()或定时 reload 配置文件——RPC 调用是高频短连接,配置热更必须原子化,否则可能一半请求走旧地址、一半走新地址
跨服务器调用时的序列化和兼容性陷阱
Workerman-JsonRpc 默认用 json_encode/decode,看似简单,但容易踩坑:
- PHP 7.4+ 的
json_encode对NaN、INF会报错,而 Workerman 不捕获这类异常,直接导致整个 worker 进程 crash - 客户端和服务端 PHP 版本不一致时,
DateTime对象 JSON 化行为不同(有的转成字符串,有的丢字段),建议所有参数/返回值统一用数组,避免传对象实例 - 大数组嵌套层级过深(>512 层)会触发
json_decode递归限制,错误信息是JSON_ERROR_DEPTH,但客户端只会收到空响应,需在服务端加json_last_error()检查
真正麻烦的从来不是“怎么连上”,而是“连上之后,谁来保证每次调用都走对的机器、拿回正确的数据、不因一个节点故障拖垮整条链路”。Workerman 给了高性能的底座,但分布式 RPC 的鲁棒性,得靠你自己补全那几块关键拼图。










