必须为每个服务实例创建独占动态队列并绑定至FanoutExchange，否则共用固定队列名会导致消息仅被单节点消费；推荐用hostname:port生成队列名，设autoDelete=true，并通过@Bean声明式绑定。
多节点服务更新本地缓存时，必须让所有实例都收到通知——FanoutExchange + 动态队列是目前最轻量、最可靠的做法。硬编码固定队列名或复用同一队列，必然导致消息被单个节点消费，其他节点收不到。
为什么不能用固定队列名做广播
多个 ECS 实例如果共用同一个 queue 名（比如都叫 "cache-clear-queue"），RabbitMQ 会把它们视为同一逻辑队列的多个消费者。此时哪怕交换机是 FanoutExchange，消息也只会投递到该队列一次，然后由其中一个消费者取走，其余节点完全无感知。
常见错误现象：
- 只有第一个启动的服务节点能清除缓存，其余节点缓存一直 stale
- 重启某个节点后，它开始收到消息，但之前在线的节点反而不收了
-
rabbitmqctl list_queues显示只有一个队列，但有多个 consumer 连接
根本原因：RabbitMQ 的“广播”是基于「队列维度」，不是「消费者维度」。要让每个节点都收到，就必须让每个节点拥有自己独占的队列。
立即学习“Java免费学习笔记（深入）”；
如何生成和绑定动态队列
关键在于让每个 JVM 实例在启动时生成唯一队列名，并立即绑定到同一个 FanoutExchange。Spring Boot 下推荐用 UUID 或 hostname:port 拼接，避免依赖外部配置。
实操建议：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 队列声明必须设
autoDelete = true，否则节点下线后队列残留，下次上线又建新队列，造成堆积 - 队列名建议包含主机标识，如
"cache-clear-queue-" + InetAddress.getLocalHost().getHostName()，便于排查 - 绑定关系要在应用启动早期完成，不能延迟到第一次监听才触发
- 不要手动调用
channel.queueBind()，应交由@Bean Binding声明式完成，避免竞态
示例片段（Spring Boot）：
@Bean
public Queue myQueue() {
String queueName = "cache-clear-queue-" + InetAddress.getLocalHost().getHostName();
return new Queue(queueName, true, false, true); // durable, exclusive, auto-delete
}
@Bean
public FanoutExchange fanoutExchange() {
return new FanoutExchange("local-cache-exchange", true, false);
}
@Bean
public Binding binding() {
return BindingBuilder.bind(myQueue()).to(fanoutExchange());
}
发送端只需发一次，无需知道有多少节点
生产者完全不用感知下游节点数量。只要往 FanoutExchange 发送一条消息，RabbitMQ 自动复制并投递到所有已绑定的队列——包括刚上线、尚未建立连接的节点，只要它的队列已声明并绑定，就能立刻收到。
注意点：
- 发送时用
rabbitTemplate.convertAndSend("local-cache-exchange", "", payload)，exchange 名必须匹配，routingKey 留空 - 消息体建议序列化为 JSON 并带版本字段（如
{"type":"config_update","version":123}），方便消费者判断是否需要处理 - 避免在发送端做重试逻辑；若 exchange 不存在，RabbitMQ 会直接丢弃消息且不报错，务必提前确保 exchange 已存在或启用
publisher-confirm
监听端必须手动 ACK，否则消息会重复消费
每个节点监听自己的队列，收到消息后执行本地缓存清除，再调用 channel.basicAck()。若未 ACK 就退出（如进程崩溃、OOM），RabbitMQ 会重新投递，导致缓存被清两次——多数场景可接受，但若清除逻辑含副作用（如写日志、发告警），需幂等设计。
典型陷阱：
- 用
@RabbitListener但没配acknowledgeMode = AcknowledgeMode.MANUAL，默认是AUTO，容易因反序列化失败或空指针跳过 ACK - 监听器方法抛出异常后，Spring 默认会拒绝消息（
basicNack），若没配defaultRequeue = false，会无限重试 - 清除缓存操作耗时较长（如批量 reload），需调大
prefetchCount防止 channel 被占满阻塞新消息
建议监听器结构：
@RabbitListener(queues = "#{myQueue.name}")
public void onCacheClear(Message message, Channel channel, @Header long deliveryTag) throws IOException {
try {
String payload = new String(message.getBody(), StandardCharsets.UTF_8);
clearLocalCache(payload);
channel.basicAck(deliveryTag, false);
} catch (Exception e) {
channel.basicNack(deliveryTag, false, false); // 不重入队，避免死循环
}
}
真正容易被忽略的是节点下线时的队列清理时机——autoDelete = true 依赖 TCP 连接断开，而 ECS 上的 Java 进程可能因 OOM 或 kill -9 无法优雅关闭，导致队列残留数小时。线上建议配合健康检查探针 + 定期脚本清理陈旧队列（按命名规则匹配 + 创建时间筛选）。
