workerman连接断开后不会自动重连,必须由客户端主动触发重连并配合服务端会话管理:客户端调用$connection->reconnect()实现tcp层重连,服务端需在onconnect中校验client_id与token签名、清理旧连接、更新redis会话键,并禁用redis读写超时、ping检测后重建实例。

Workerman连接断开后不会自动重连,必须由客户端主动触发重连动作并配合服务端会话管理逻辑,否则旧连接残留、重复登录、Redis键堆积等问题会迅速导致服务不可用。
客户端调用reconnect()实现TCP层重连
Workerman从v3.3.5起为AsyncTcpConnection类内置reConnect方法,这是唯一官方支持的自动重连入口。
在onClose回调中直接调用$connection->reConnect()即可启动重连流程。
推荐传入延迟参数:$connection->reConnect(3.5),避免对端服务未就绪时高频轮询打满CPU——【不加延迟可能导致本机CPU持续100%】。
若使用WebSocket连接,需前端JavaScript同步实现重连逻辑,服务端无需、也无法干预此过程。
服务端必须配合会话状态清理
重连不是简单重建连接,而是要让新连接接管旧会话上下文。这依赖三步原子操作:
第一步:在onConnect中解析首次消息,提取client_id并校验token签名有效性;
第二步:查Redis Hash(key为client_id),确认该client_id是否已绑定其他connection_id;
第三步:若存在旧连接,调用$old_connection->close()强制下线,并删除Redis中对应字段;
第四步:将新connection_id写入Redis,设置过期时间(建议比心跳超时阈值多留10秒缓冲)。
注意:client_id不能来自URL参数或Cookie,必须在首帧onMessage中以JSON结构体携带,且含HMAC-SHA256签名——【仅靠IP或连接时间戳无法防重放攻击】。
Redis连接断开后如何自动恢复
方法一:初始化必须放在onWorkerStart里,每个Worker进程独享一个Redis实例。
方法二:构造Predis\Client时显式禁用读写超时——new Predis\Client('tcp://127.0.0.1:6379?read_write_timeout=0')。
方法三:关键操作前先执行$redis->ping() === false判断连接有效性,失败则unset($redis)并重建新实例。
切勿在onMessage或onClose中尝试重连Redis,那会导致连接句柄泄漏和进程崩溃。











