workerman 4异步redis订阅收不到消息，主因是连接未长期存活、事件循环被阻塞或回调注册错误；需确保subscribe在onworkerstart执行、使用workerman/redis^2.0.3、回调含$channel和$message两参数，并排除redis密码、docker端口及键空间事件配置干扰。

Workerman 4 使用异步 Redis 客户端做 subscribe 或 pSubscribe 时收不到消息，问题通常不出在业务逻辑，而是运行模型、连接生命周期或事件循环被意外中断。关键在于：订阅必须长期保持连接活跃，且不能被 onMessage 或其他回调中途关闭或覆盖。

确认 Redis 订阅连接是否真正建立并持续存活

异步订阅不是“发一次命令就完事”，而是一个长连接+事件监听过程。需验证：

• 客户端调用的是 subscribe(['channel1']) 或 pSubscribe(['pattern*'])，而不是 get()/set() 等短连接命令；
• 订阅操作必须在 onWorkerStart 中执行（或在独立的常驻 Worker 里），不能放在 onMessage 里——后者每次触发都是临时上下文，连接会随回调结束被释放；
• 检查 Redis 服务端是否允许发布/订阅：执行 redis-cli -p 6379 ping 确认连通后，再执行 redis-cli -p 6379 pubsub channels，看目标 channel 是否出现在列表中（说明有客户端已成功订阅）。

检查 Workerman 4 的事件循环是否被阻塞或替换

Workerman 4 默认使用自己的 ReactPHP 兼容事件循环，但若项目中混入了其他协程库（如 Swoole 扩展）、手动调用了 sleep()、usleep() 或同步 Redis 扩展（phpredis），会导致事件循环卡死，订阅回调无法触发。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

• 禁止在 onWorkerStart 或订阅回调中使用任何同步阻塞操作；
• 确保未启用 extension=swoole.so（与 Workerman 不兼容）；
• 若用了 workerman/redis 组件，确认版本为 ^2.0.3，它专为 Workerman 4 的事件模型适配，老版本可能无法正确注册订阅事件。

验证订阅回调是否被正确注册且未被覆盖

订阅成功后，消息是通过回调函数接收的，不是走 onMessage。常见错误是把回调写错位置或漏掉参数：

• 正确写法示例：

$client->subscribe(['log'], function ($channel, $message) {
  echo "收到 $channel: $message\n";
});

• 回调必须有两个参数：$channel 和 $message，少一个会导致静默失败；
• 不要在回调里直接调用 $connection->send()（除非你确定该连接还活着），更不要在其中抛出未捕获异常——这会让整个 Worker 进程崩溃退出；
• 建议在回调开头加日志：file_put_contents('/tmp/redis_sub.log', date('Y-m-d H:i:s')." $channel:$message\n", FILE_APPEND);，确认消息是否真的抵达。

排除 Redis 服务端和网络层干扰

即使客户端代码无误，也可能因服务端配置或中间件拦截导致收不到消息：

• Redis 默认禁用 notify-keyspace-events，但普通 SUBSCRIBE 不依赖它；不过如果你用的是 psubscribe 匹配键空间事件，请确认已开启：CONFIG SET notify-keyspace-events Ex；
• 检查 Redis 是否运行在 Docker 中且未暴露 6379 端口给 Workerman 所在容器；
• 若 Redis 启用了密码，连接字符串必须带 auth，例如：redis://:yourpass@127.0.0.1:6379，否则订阅会失败但不报错；
• 用 tcpdump -i any port 6379 抓包，确认是否有 SUBSCRIBE 命令发出、是否有 MESSAGE 响应返回，可快速定位是客户端没发出去，还是服务端没推过来。