redismessagelistenercontainer需手动声明bean且必须配置setconnectionfactory；监听器须实现messagelistener并用addmessagelistener注册，patterntopic需redis开启notify-keyspace-events，channeltopic仅匹配精确频道。
RedisMessageListenerContainer 是 Spring Boot 集成 Redis 发布订阅的入口，但直接配它容易踩坑——比如监听器不生效、消息丢失、线程阻塞或频道匹配错位。关键不在“能不能用”，而在“怎么让它稳定跑起来”。
为什么 addMessageListener 有时不触发？
最常见原因是：监听器注册时用了 PatternTopic 却误以为它等价于 ChannelTopic，或者反过来。
-
ChannelTopic("redis.news")只匹配精确频道名redis.news，大小写敏感，不支持通配符 -
PatternTopic("redis.*")才能匹配redis.news、redis.life等，但注意 Redis 服务端需开启notify-keyspace-events（仅限 keyevent 类型） - 如果用
PatternTopic订阅普通业务频道（如order.*），必须确认客户端用的是convertAndSend而非publish原生命令——Spring Data Redis 的PatternTopic依赖内部事件机制，不是原生 Redis pub/sub 的模式匹配
MessageListenerAdapter 的方法名必须叫 onMessage 吗？
不一定，但必须显式指定。默认构造函数会尝试调用 handleMessage，不是 onMessage。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 如果你的处理器类叫
OrderEventHandler，且想用handleOrderCreated方法处理消息，就得这样写：new MessageListenerAdapter(handler, "handleOrderCreated") - 如果不传方法名，
MessageListenerAdapter会反射查找handleMessage，找不到就抛IllegalArgumentException - 方法签名必须是
void handleXxx(Message message, byte[] pattern)或void handleXxx(String message, String channel)（后者需配合StringRedisTemplate和文本序列化）
如何避免监听器启动后收不到第一条消息？
因为 RedisMessageListenerContainer 默认懒初始化，首次收到消息才真正建立连接——这会导致“发布早于订阅”时消息丢失。
- 在
@Bean定义里加container.setPhase(1)，让容器随应用上下文一起提前初始化 - 确保
RedisConnectionFactory已就绪；若用 Lettuce，检查clientName是否被复用导致连接冲突 - 不要依赖
@PostConstruct手动调用publish测试——此时监听器可能还没绑定到连接上，应改用外部工具（如 redis-cli）发测试消息验证
频道名含点号或斜杠时为什么订阅失败？
Spring Data Redis 对频道名不做转义，但某些 Redis 客户端（尤其是旧版 Jedis）会对 .、/ 等字符做特殊处理，导致匹配失效。
- 推荐统一用下划线代替点号：
user_order_created而非user.order.created - 如果必须用层级结构，改用
PatternTopic并确保所有发布方都走StringRedisTemplate.convertAndSend()，避免混用原生命令 - 调试时用
redis-cli --scan --pattern "redis.*"查看实际存在的频道，比代码日志更可信
addMessageListener 调用都要对应一次可验证的订阅行为。
