php 8.6使用phpredis消费stream时,应先处理本消费者未确认的消息,业务写入成功后再执行xack。下面以sqlite记录接收结果,用消息id唯一约束容忍重复投递;需要redis、pdo_sqlite扩展及redis 5以上,消费者名称在同一工作实例重启后保持稳定。

Redis官方文档中的XREADGROUP
创建消费者组并读取一批消息
<?php
$r=new Redis(); $r->connect('127.0.0.1',6379,2);
$r->setOption(Redis::OPT_READ_TIMEOUT,5);
try { $r->xGroup('CREATE','jobs','workers','0',true); }
catch (RedisException $e) {
if (!str_contains($e->getMessage(),'BUSYGROUP')) throw $e;
}
$db=new PDO('sqlite:/srv/app-private/received.sqlite',null,null,
[PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION]);
$db->exec('CREATE TABLE IF NOT EXISTS received(id TEXT PRIMARY KEY,payload TEXT NOT NULL)');
$put=$db->prepare('INSERT OR IGNORE INTO received(id,payload) VALUES(?,?)');
$consumer='worker-a';
$messages=$r->xReadGroup('workers',$consumer,['jobs'=>'0'],20);
if (!$messages || empty($messages['jobs'])) {
$messages=$r->xReadGroup('workers',$consumer,['jobs'=>'>'],20,1000);
}
foreach (($messages['jobs']??[]) as $id=>$fields) {
if (!is_array($fields) || !isset($fields['payload'])) {
throw new RuntimeException('消息格式不符,保留pending等待处理');
}
$put->execute([$id,$fields['payload']]);
$r->xAck('jobs','workers',[$id]);
}
Redis官方文档中的XACK
分别检查业务记录和Pending列表
可先用XADD jobs * payload hello写入一条测试消息,再运行脚本。正常结果是SQLite保留一条记录、该消息不再处于本组pending。数据库写入后、ACK前退出会再次接收同一ID;唯一约束让接收表不重复插入,但邮件、支付等外部副作用仍需要自己的幂等机制。
处理退出的消费者
0只读取当前消费者的待确认消息,>只读取组内新消息。其他已退出消费者的消息不会自动转移;Redis 6.2以上可按XAUTOCLAIM的空闲阈值接管,阈值要大于正常处理时长。不要用NOACK替代成功确认;坏消息应按明确策略进入隔离队列,避免反复阻塞。



















