ActiveMQ客户端连通不等于环境配置正确：需确保JDK≥11且java/javac版本一致、依赖仅用activemq-client或spring-boot-starter-activemq、broker绑定0.0.0.0并开放防火墙端口、连接必须start()、destination类型须匹配模式、认证失败时抓包确认RST。
ActiveMQ 客户端能连上，不代表环境配对了——JDK 版本错、依赖版本混、broker 地址没开权限，三者任一出问题，Connection refused 或 Invalid broker URI 就会卡死你十分钟。
确认 JDK 是真能用的，不是“有就行”
ActiveMQ 5.17.x 起明确要求 JDK 11+，但很多机器上 java -version 显示 11，实际跑 activemq-client 时却报 UnsupportedClassVersionError。这是因为：
• activemq-client 编译目标字节码版本必须 ≤ 当前 JVM 支持的版本
• 某些 OpenJDK 构建（如某些 Alpine 镜像）缺 JMS API 类，需额外加 jakarta.jms-api
• Spring Boot 3 默认不带 JMS 自动配置类，得显式启用
- 检查方式：
java -version和javac -version必须一致，且 ≥ 11 - 验证客户端兼容性：在项目里跑一句
new ActiveMQConnectionFactory("tcp://localhost:61616")，不抛NoClassDefFoundError才算过关 - Spring Boot 用户注意：
spring-boot-starter-activemq5.17+ 对应的是 Jakarta EE 9+ 命名空间，别再用javax.jms.*
选对 client 依赖，别被 activemq-all 坑了
开发时图省事加 activemq-all，上线后发现包体积暴涨、类冲突频发——它把 Jetty、XBean、甚至旧版 Log4j 全打进去，和 Spring Boot 内置容器打架是常态。
- 生产环境只用：
org.apache.activemq:activemq-client:5.17.6（纯客户端，无服务端逻辑） - Spring Boot 3 项目优先用：
org.springframework.boot:spring-boot-starter-activemq，它自动管理连接池和异常重试 - 绝对避开：
activemq-spring-boot-starter（非官方，已废弃）和activemq-karaf（OSGi 专用）
broker-url 不只是写个 localhost
本地测试 tcp://localhost:61616 没问题，一上 Docker 或云服务器就连不上——根本原因是 ActiveMQ 默认 bind 到 127.0.0.1，外部网络访问被拒。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 改法在
conf/activemq.xml中：0.0.0.0，不是*或空 - 防火墙必须放行：
61616（消息端口），8161（控制台仅调试用，生产建议关掉） - Docker 场景下，
-p 61616:61616不够，还得加--network host或配ACTIVEMQ_OPTS指定 advertised IP
第一次发消息失败？先看这三件事
代码跑通、没报错、但控制台里队列始终为空——大概率是没 commit、没 start connection、或用错了 destination 类型。
-
connection.start()必须调，否则消费者收不到任何消息（JMS 规范强制要求） - 队列模式下用
session.createQueue("my.queue")，主题模式用session.createTopic("my.topic")，混用直接静默丢弃 - Spring Boot 默认
jms.pub-sub-domain=false（即队列模式），若想用 topic，yml 里得显式设为true
Broker 端开了认证、客户端没传 user/password，错误日志里可能只显示 Transport failed，不会说“认证失败”。这种时候，别猜，直接抓包看 TCP 层是否在三次握手后立刻 RST —— 是的话，八成是 auth 挡在了 transport 层外面。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
