tomcat与rabbitmq可共用jdk（java_home须指向jdk根目录，非jre），但erlang相关变量（erlang_home、rabbitmq_server）必须独立配置并加入系统path；rabbitmq 3.12+默认禁用guest远程登录和classic queue，需显式创建用户、赋权并声明quorum_queue。

Tomcat 和 RabbitMQ 能共用一套 JDK 环境变量，但不能共用同一套 PATH 或服务级环境变量；RabbitMQ 依赖 Erlang，而 Tomcat 只认 JAVA_HOME —— 这是集成失败最常见的根源。

Tomcat 的 JAVA_HOME 必须指向 JDK，不是 JRE

很多人把 JAVA_HOME 指向 C:\Program Files\Java\jre1.8.0_301，结果 Tomcat 启动报 Neither the JAVA_HOME nor the JRE_HOME environment variable is defined。JRE 不含 javac 和 tools.jar，Tomcat 编译 JSP、加载某些类时会失败。

• JAVA_HOME 应设为 JDK 安装根目录，例如：C:\Program Files\Java\jdk-17.0.2
• Windows 下需在系统变量中新增 JAVA_HOME，再把 %JAVA_HOME%\bin 加入 Path
• Linux 下建议在 /etc/profile 中设置，并执行 source /etc/profile，避免只对当前 shell 生效
• 验证方式：终端运行 echo $JAVA_HOME（Linux）或 echo %JAVA_HOME%（Windows），再运行 java -version 和 javac -version 确保两者版本一致

RabbitMQ 的 ERLANG_HOME 和 RABBITMQ_SERVER 必须独立配置

Tomcat 不关心 Erlang，但 RabbitMQ 启动失败时，错误日志里常出现 erl not found 或 Failed to start application rabbit，根本原因就是 ERLANG_HOME 没配，或配了但没重启命令行/服务。

RabbitMQ 4.2.3

RabbitMQ 4.2.3 是 2026 年初发布的重要稳定更新版本，重点修复了 Khepri 元数据存储相关问题，并改进了监控性能。对于使用 Docker、Kubernetes 或微服务架构的开发团队来说，该版本兼容性和稳定性表现较好。

下载

• ERLANG_HOME 必须指向 Erlang 安装目录下的 erts-X.X.X 上一级（如 C:\Program Files\Erlang OTP\26.0），不是 bin 子目录
• RABBITMQ_SERVER 是 RabbitMQ 安装根路径（如 C:\Program Files\RabbitMQ Server\rabbitmq_server-3.12.14）
• Windows 下这两项必须加入“系统变量”，且 %ERLANG_HOME%\bin 和 %RABBITMQ_SERVER%\sbin 都要追加进 Path
• Linux 下不推荐用 export 写进用户 profile，应写入 /etc/environment 或 RabbitMQ 启动脚本头部，否则 systemctl 启动时变量不可见

Tomcat 应用连接 RabbitMQ 时，不要硬编码连接参数

直接在 Java 代码里 new ConnectionFactory() 并填死 setHost("localhost")、setPort(5672)，上线后改 IP 就得重编译。更糟的是，若 RabbitMQ 开了 TLS 或启用了 vhost，硬编码会导致连接拒绝，错误信息通常是 connection closed abruptly 或 ACCESS_REFUSED - Login was refused。

• 推荐通过 Tomcat 的 context.xml 配置 JNDI 资源：<resource name="jms/rabbitmq" auth="Container" type="com.rabbitmq.client.ConnectionFactory" factory="org.apache.naming.factory.BeanFactory" host="rabbitmq-prod" port="5672" virtualhost="/prod" username="appuser" password="s3cr3t"></resource>
• 应用内用 InitialContext.lookup("java:comp/env/jms/rabbitmq") 获取实例，解耦配置与代码
• 若用 Spring Boot，优先走 application.yml 的 spring.rabbitmq.* 配置项，避免手动管理 ConnectionFactory 生命周期
• 注意：RabbitMQ 3.12+ 默认禁用 classic queue，启用 quorum_queue，消费者端需显式声明队列类型，否则 declareQueue() 报错 NOT_FOUND

常见端口冲突和权限问题必须提前排查

Tomcat 默认占 8080，RabbitMQ 管理界面默认占 15672，但 Erlang 分布式通信端口（25672）和 AMQP 端口（5672）容易被防火墙拦截或被其他服务占用，导致 Tomcat 应用连不上 RabbitMQ，错误表现为 java.net.ConnectException: Connection refused。

• Windows 下检查：用 netstat -ano | findstr :5672 查端口占用，用 tasklist | findstr <pid></pid> 找进程名
• Linux 下执行 ss -tuln | grep ':5672'，确认 rabbitmq-server 进程是否监听 0.0.0.0:5672（而非仅 127.0.0.1）
• RabbitMQ 3.12 默认关闭 guest 用户远程登录，必须创建新用户并赋权：rabbitmqctl add_user appuser p@ssw0rd → rabbitmqctl set_user_tags appuser management → rabbitmqctl set_permissions -p /prod appuser ".*" ".*" ".*"
• Tomcat 运行用户（如 Linux 的 tomcat 用户）无需对 RabbitMQ 目录有读写权，但必须能发起 outbound TCP 连接 —— SELinux 或 AppArmor 可能拦截，可临时用 setenforce 0 测试是否为此类限制

真正卡住人的从来不是安装步骤，而是环境变量生效范围、Erlang 与 RabbitMQ 版本的隐式绑定、以及 RabbitMQ 3.12 后对 guest 用户和 classic queue 的默认限制 —— 这些细节不验证到具体输出，光看文档永远调不通。