rabbitmq 通过虚拟主机（vhost）实现多租户隔离，每个 vhost 是独立的逻辑消息实例，拥有专属队列、交换器、权限系统和命名空间；java 客户端需显式设置 vhost（如 factory.setvirtualhost("tenant_a")），配合独立用户与精细化权限控制，确保租户间完全隔离且安全。
RabbitMQ 通过虚拟主机（Virtual Host，简称 vhost）天然支持多租户隔离，Java 客户端只需在连接时指定不同的 vhost，即可让不同租户的队列、交换器、绑定关系完全独立，互不干扰。
每个租户独占一个 vhost
vhost 是 RabbitMQ 最基础的隔离单元，相当于一个逻辑上的“消息服务器实例”。它拥有独立的权限系统、队列命名空间和交换器集合。不同 vhost 下即使队列名相同，也完全无关。
- 创建 vhost：用命令行 rabbitmqctl add_vhost tenant_a 或管理界面新增
- 为用户授权：执行 rabbitmqctl set_permissions -p tenant_a app_user ".*" ".*" ".*"，确保用户对目标 vhost 有完整权限
- 避免共用 vhost：切勿让多个租户共享同一个 vhost，否则队列名冲突、ACL 难以精细化控制
Java 客户端连接时显式指定 vhost
ConnectionFactory 默认 vhost 是 /，必须主动设置才能接入租户专属空间。
- 代码示例：
ConnectionFactory factory = new ConnectionFactory();
factory.setVirtualHost("tenant_a"); // 关键！
factory.setHost("localhost");
factory.setPort(5672);
factory.setUsername("app_user");
factory.setPassword("pass123");
Connection conn = factory.newConnection(); - Spring Boot 中可通过 spring.rabbitmq.virtual-host=tenant_b 配置
- vhost 名称需 URL 编码：若含斜杠或特殊字符（如 /prod/tenant-1），连接时必须编码为 %2Fprod%2Ftenant-1
配合用户与权限实现租户级访问控制
仅靠 vhost 不足以保障安全，必须绑定用户 + 权限策略，防止越权访问。
- 为每个租户创建独立用户（如 tenant_a_user），禁止使用 admin 公共账号
- 权限粒度到 vhost 级：用户只能操作自己 vhost 内的资源，无法 list 或 declare 其他租户的队列
- 可限制具体操作：例如只允许生产者写入 exchange，不允许消费者声明 queue（由部署脚本预创建）
注意跨 vhost 的常见误区
vhost 之间完全隔离，任何跨 vhost 的操作都无效或报错。
- 不能在 vhost A 中声明 vhost B 的 exchange 或 queue —— 会直接抛出 IOException: CHANNEL_ERROR
- 无法通过 federation 或 shovel 跨 vhost 转发消息（它们工作在 vhost 内部），如需数据流转，应走应用层中转或使用独立 vhost + 显式路由逻辑
- 监控与告警需按 vhost 维度配置，管理界面默认只显示当前登录用户有权访问的 vhost
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
