Workerman实现Redis队列消费的核心是用BRPOP替代RPOP+sleep轮询,避免CPU空转和Redis无效负载;每个Worker独占Redis连接,超时设1秒,配合多进程并发与手动失败重试,确保高可用与稳定性。

Workerman 实现异步 Redis 队列消费,核心不是“让 Workerman 自带队列功能”,而是用它常驻内存、多进程、事件驱动的特性,去高效、稳定地 BRPOP 消费 Redis List。关键在于避免轮询、控制并发、隔离失败任务——否则容易卡死、漏单、压垮 Redis。
为什么不能用 RPOP + sleep 轮询?
这是新手最常踩的坑:在定时器里反复 RPOP,没数据就 sleep(1)。问题很直接:
-
RPOP是非阻塞的,空队列时立刻返回null,导致 CPU 空转、Redis 连接频繁建立销毁 - 每秒几十次无意义请求,对 Redis 是无效负载,监控里
instantaneous_ops_per_second会虚高 - 无法精准控制消费节奏,比如想“有任务才处理,没任务就歇着”,
BRPOP才是正解
正确做法是改用 BRPOP,它会在队列为空时阻塞连接,直到新任务到达或超时。超时时间建议设为 1 秒,既防长阻塞,又避免高频轮询。
BRPOP 怎么在 Workerman 里安全使用?
Workerman 的 Worker 进程是单线程的,BRPOP 会阻塞当前进程——这没问题,正是我们想要的“空闲即休眠”。但要注意三点:
- 每个 Worker 进程必须创建自己的
Redis实例,不能共用一个连接(否则多个进程BRPOP会互相干扰) -
BRPOP超时后必须检查返回值是否为false或空数组,再决定是否继续下一轮,不能无条件重试 - 业务逻辑出错时,别直接
exit或抛未捕获异常,否则整个 Worker 进程退出,少一个消费者
示例片段(关键逻辑):
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$queueName = 'queue:order';
Timer::add(0.1, function() use ($redis, $queueName) {
// 阻塞最多 1 秒,返回形如 [queue_name, task_json] 或 false
$result = $redis->brPop([$queueName], 1);
if (is_array($result) && count($result) === 2) {
$taskData = json_decode($result[1], true);
processTask($taskData);
}
});
并发控制和失败重试怎么落地?
Workerman 本身不提供重试机制,得自己封装。重点不是“重试几次”,而是“重试是否合理”:
- 网络超时、HTTP 请求失败这类临时错误,适合短间隔重试(如
[1, 5, 30]秒) - 数据库唯一键冲突、参数校验失败这类业务错误,重试毫无意义,应直接记录日志并丢弃,或转入死信队列(
LPUSH queue:dlq ...) - 并发靠
$worker->count控制进程数,但注意:每个进程对应一个 Redis 连接,max_connections需同步调大(Redis 默认 10000,一般够用)
别把 concurrent => false 当成“顺序执行”保障——Redis List 本身是 FIFO,但多个 Worker 并发 BRPOP 仍可能因处理速度不同导致乱序。真要严格顺序,只能单进程 + BRPOP,或改用 Redis Stream + XREADGROUP。
配置和部署最容易忽略的三个点
很多项目跑着跑着就停了,往往不是代码问题,而是环境细节没对齐:
- Linux 下用
php start.php start -d启动,但忘记加nohup或 systemd 管理,终端关闭进程就死了 - Windows 开发用
start_for_win.bat,但生产环境没切到 Linux,pcntl_fork不可用,多进程实际退化为单进程 - Redis 密码或
auth配置写错,Worker 启动时不报错(因为连接延迟到第一次BRPOP才触发),但始终消费不到数据,排查时容易误判为队列没推入
真正难的从来不是写几行 BRPOP,而是让这几十行代码,在凌晨三点服务器负载飙升时,依然稳稳地从 Redis 里捞出那条该处理的订单。


















