无法连接ActiveMQ Classic：M1 Mac环境下JMS集成连接故障

针对应用无法连接Docker部署的ActiveMQ 5.17.3、报错org.apache.activemq.transport.InactivityIOException: Cannot send, channel has already failed且能正常访问管理控制台的情况，按以下步骤排查：

• 检查端口映射与本地监听状态

  1. 执行docker ps查看ActiveMQ容器的端口映射，确认61616/tcp是否绑定到0.0.0.0:61616（而非仅容器内部）。
  2. 在终端执行lsof -i :61616或netstat -an | grep 61616，验证本地主机是否真的在监听61616端口。如果没有监听，重新启动容器并确保端口映射参数正确（-p 61616:61616）。

• 调整连接URL的主机地址
  Docker日志显示Broker监听tcp://somelaptopid:61616，尝试将应用的JMS连接URL替换为以下任一方式测试：

  • 用容器IP：通过docker inspect <activemq-container-id>获取容器的IP地址，改为tcp://<container-ip>:61616
  • 用主机的局域网IP（而非127.0.0.1），比如tcp://192.168.x.x:61616
  • 尝试禁用Docker的IPv6支持，避免DNS解析优先使用IPv6导致连接失败

• 排查InactivityMonitor心跳配置
  该报错与连接心跳检测直接相关，尝试在连接URL中添加心跳参数：

  tcp://127.0.0.1:61616?wireFormat.maxInactivityDuration=0&wireFormat.maxInactivityDurationInitalDelay=30000
  

  • maxInactivityDuration=0会禁用心跳检测（仅用于测试），如果连接成功，说明是心跳配置不匹配问题，再调整为与服务端一致的默认值（30000ms）。

• 检查XA事务配置（针对Atomikos场景）
  报错涉及Atomikos的JmsTransactionalResource，需确认：

  1. 应用中使用的是ActiveMQXAConnectionFactory而非普通连接工厂，且配置的用户名、密码与ActiveMQ控制台一致。
  2. Atomikos的事务资源配置中，连接池的最大空闲时间、超时时间是否与ActiveMQ的连接超时兼容，避免连接被提前回收。
  3. 检查ActiveMQ的activemq.xml中是否启用了XA支持（默认已启用，无需额外配置，但可确认<broker>标签的persistent="true"等参数）。

• 排查系统防火墙与代理

  1. 关闭Mac的系统防火墙（临时测试），或在防火墙设置中允许应用访问61616端口。
  2. 关闭正在运行的代理工具（如Charles、VPN），这类工具可能拦截TCP连接或修改网络路由。

• 验证Docker网络模式
  如果使用了host网络模式，Mac的Docker host网络与本地主机网络隔离，无法通过127.0.0.1访问，需切换为默认的bridge模式并确保端口映射正确，或使用Docker网关IP（通常为172.17.0.1）作为连接地址。

内容的提问来源于stack exchange，提问作者Julian