ActiveMQ 5.15+ 要求 JDK 8 或更高版本，需验证 JAVA_HOME 指向完整 JDK（含 javac），且 java/javac -version 一致；端口 61616 和 8161 不可被占用，jetty.xml 中 host 必须设为 0.0.0.0 并重启生效。
确认 Java 环境是否满足 ActiveMQ 运行要求
ActiveMQ 5.15+ 强制依赖 JDK 8 或更高版本，JDK 7 及以下会启动失败并报 UnsupportedClassVersionError。别只看 java -version 输出带 “1.8”，还要验证 JAVA_HOME 指向的是完整 JDK（含 javac），而非仅 JRE。
常见踩坑点：
-
/etc/profile中JAVA_HOME路径写错（比如漏掉/jdk1.8.0_181子目录） - 执行
source /etc/profile后未在新 shell 中验证，导致activemq脚本仍调用系统默认旧版 Java - 某些 CentOS 系统预装 OpenJDK，但 ActiveMQ 对部分 OpenJDK 实现兼容性差，建议优先用 Oracle JDK 或 Temurin（Eclipse Adoptium）构建的 JDK 8/11
验证命令必须逐条运行：
echo $JAVA_HOME java -version javac -version
单节点启动失败时重点排查 activemq 脚本和端口冲突
直接执行 ./activemq start 无报错但进程没起来，大概率是脚本内部逻辑被绕过或端口被占。ActiveMQ 默认绑定 61616（消息端口）和 8161（Web 控制台），任一被占用都会静默失败。
排查步骤：
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 先用
netstat -tuln | grep -E '(:61616|:8161)'或lsof -i :61616确认端口空闲 - 不要跳过日志——加
./activemq start && tail -f data/activemq.log实时看启动过程，90% 的初始化失败会在 log 中明确提示（如Failed to load type: org.apache.activemq.store.kahadb.KahaDBPersistenceAdapter表示持久化配置语法错误） - 检查
bin/activemq脚本头部是否硬编码了JAVA_HOME；若已全局配置，可注释掉脚本内重复设置，避免覆盖
高可用集群必须关闭 LevelDB，改用 ZooKeeper + Replicated LevelDB（5.13+）
ActiveMQ 官方从 5.9 开始废弃纯 Master-Slave 文件共享模式，5.13+ 版本中 replicatedLevelDB 已移除，必须用 replicatedLevelDB 的替代方案：ZooKeeper 协调的 replicatedLevelDB 实际已不可用，正确路径是启用 zkPaxos 或回退到基于 JDBC + shared database 的方式。但生产环境最稳的是 ZooKeeper + replicatedLevelDB 的继任者 —— replicatedLevelDB 已被弃用，当前可靠方案是 jdbcPersistenceAdapter 配合外部数据库（如 PostgreSQL），或升级至 ActiveMQ Artemis（官方推荐替代品）。
若坚持用 Classic ActiveMQ 做 HA，唯一可行路径是：
- 三台节点均部署相同版本（如
apache-activemq-5.16.3） - 修改
conf/activemq.xml，注释掉原persistenceAdapter，替换为jdbcPersistenceAdapter并配置dataSource指向共享 PostgreSQL/MySQL - 确保所有节点的
brokerName一致，且networkConnector配置双向互通 - ZooKeeper 不再用于 Classic ActiveMQ 的主从选举，它只在 Artemis 中承担该角色
jetty.xml 修改后 Web 控制台无法访问的典型原因
改完 conf/jetty.xml 里 host 或 port 后打不开 http://ip:8161/admin，不是配置没生效，而是 Jetty 绑定逻辑比想象中严格。
关键点：
-
<property name="host" value="0.0.0.0"/>必须显式设置，设成127.0.0.1将导致外网无法访问 - Jetty 的 SSL 配置块若未注释，可能强制重定向到
https://，而你没配证书，浏览器直接拒绝连接 - 修改后必须重启 ActiveMQ（
./activemq stop && ./activemq start），Jetty 不支持热加载配置 - 防火墙常被忽略：
firewall-cmd --permanent --add-port=8161/tcp && firewall-cmd --reload
最简验证法：启动后立刻执行 ss -tlnp | grep :8161，看到 java 进程监听 *:8161 才算真正绑定成功。
