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，外部网络访问被拒。
- 改法在
conf/activemq.xml中：<transportconnector name="openwire" uri="tcp://0.0.0.0:61616?..."></transportconnector>，注意是0.0.0.0，不是*或空 - 防火墙必须放行：
61616（消息端口），8161（控制台仅调试用，生产建议关掉） - Docker 场景下，
-p 61616:61616不够，还得加--network host或配ACTIVEMQ_OPTS指定 advertised IP
第一次发消息失败？先看这三件事
代码跑通、没报错、但控制台里队列始终为空——大概率是没 commit、没 start connection、或用错了 destination 类型。
立即学习“Java免费学习笔记（深入）”；
-
connection.start()必须调，否则消费者收不到任何消息（JMS 规范强制要求） - 队列模式下用
session.createQueue("my.queue")，主题模式用session.createTopic("my.topic")，混用直接静默丢弃 - Spring Boot 默认
jms.pub-sub-domain=false（即队列模式），若想用 topic，yml 里得显式设为true
Transport failed，不会说“认证失败”。这种时候，别猜，直接抓包看 TCP 层是否在三次握手后立刻 RST —— 是的话，八成是 auth 挡在了 transport 层外面。 
