Redis的发布订阅（Pub/Sub）模式是很多项目里实现实时消息推送的首选方案，比如聊天室、实时通知、行情推送这类场景。而PUBLISH命令正是整个发布订阅体系里发送消息的入口。虽然命令本身只有几个参数，但不少人第一次用时都会遇到消息发出去却收不到、订阅端时断时续等问题。这篇文章会从命令语法讲起，把发布订阅的工作机制、操作细节和常见坑点一次说清楚。
PUBLISH命令的基本语法与返回值
PUBLISH命令的语法非常简单，格式为PUBLISH channel message。其中channel是频道的名字，可以自定义任意字符串，比如news.chat、order.paid这样的命名都很常见；message就是要发送的消息内容，通常是字符串，也可以是序列化后的JSON数据。
命令的返回值是一个整数，表示收到这条消息的订阅者数量。这个返回值很有参考意义：如果返回0，说明当前没有任何客户端订阅这个频道，消息发出去就直接丢弃了，不会被存储。这一点和RabbitMQ、Kafka这类专业消息队列完全不同，Redis的发布订阅是即发即弃的，没有持久化机制，这也是后面踩坑问题的根源之一。
# 向 news.chat 频道发布一条消息 127.0.0.1:6379> PUBLISH news.chat "hello redis" (integer) 2 # 返回 2 表示有两个订阅者收到了消息 # 返回 0 表示当前无人订阅，消息已被丢弃
发布订阅的工作机制与操作流程
要真正用好PUBLISH，必须理解它的底层机制。Redis内部为每个频道维护一个订阅者链表，客户端执行SUBSCRIBE命令后，Redis把这个客户端的连接信息挂到对应频道的链表上。当有客户端执行PUBLISH时，Redis遍历该频道的订阅者链表，把消息逐一写到每个订阅客户端的网络输出缓冲区里。整个过程是内存中直接转发，不落盘、不入队列，所以速度极快，但也意味着订阅者必须在线才能收到消息。
完整的操作流程需要至少两个客户端。第一步，打开一个客户端执行订阅：
# 客户端A：订阅 news.chat 频道 127.0.0.1:6379> SUBSCRIBE news.chat Reading messages... (press Ctrl-C to quit) 1) "subscribe" 2) "news.chat" 3) (integer) 1
第二步，打开另一个客户端发布消息：
# 客户端B：发布消息 127.0.0.1:6379> PUBLISH news.chat "第一条推送" (integer) 1
此时客户端A会立即收到包含消息内容的响应。除了精确匹配频道的SUBSCRIBE，Redis还提供PSUBSCRIBE支持模式匹配订阅，比如PSUBSCRIBE news.*可以订阅所有以news开头的频道，这在频道按业务分类时非常实用。用代码实现的话，以Python为例：
import redis
r = redis.Redis(host='127.0.0.1', port=6379)
# 订阅端：监听频道
pubsub = r.pubsub()
pubsub.subscribe('news.chat')
for msg in pubsub.listen():
if msg['type'] == 'message':
print('收到消息:', msg['data'])
# 发布端：另一个进程中执行
# r.publish('news.chat', 'hello from python')
常见问题与避坑要点
第一个高频问题：为什么消息发了但订阅者收不到？最常见的原因是订阅端还没执行SUBSCRIBE，发布端就已经PUBLISH了，消息直接被丢弃。排查时可以先执行PUBSUB CHANNELS命令查看当前活跃的频道列表，确认订阅关系确实建立成功。另外要注意，执行了SUBSCRIBE的客户端会进入订阅模式，此时不能再执行普通命令，只能接收消息或执行PING等少数命令，很多新手在这个连接上执行SET命令报错就懵了。
第二个问题是消息丢失。Redis的发布订阅不保证消息送达，如果订阅者断线重连，断线期间的消息无法补收。对可靠性有要求的场景，建议改用Redis 5.0以上版本提供的Stream类型，它支持消费者组和消息确认机制，或者直接上专业的消息队列。此外在Redis集群模式下也要留心，PUBLISH默认会在集群所有节点间广播，开启
第三个细节是频道命名。建议用业务.事件这样的点分层级命名，比如order.created、order.paid，配合PSUBSCRIBE的模式匹配可以灵活订阅某一类事件。同时注意，如果一条消息同时命中普通订阅和模式订阅，订阅者会收到两份内容相同但类型不同的消息，处理时要根据消息类型字段区分，避免重复消费的业务逻辑问题。
最后总结一下：PUBLISH命令简单但背后机制要吃透，记住三点就能避开大部分坑，消息即发即弃不持久化、订阅者必须先在线订阅、订阅模式连接不能执行普通命令。掌握这些，用Redis做实时推送就能得心应手了。
Redis Publish发布订阅Redis订阅修改时间：2026-09-13 12:22:29