“Could not connect to broker URL”错误的根本原因是客户端无法建立到ActiveMQ消息代理的网络连接，需依次排查服务状态、端口监听、防火墙规则、transportConnector配置及客户端URL格式是否正确。
如果您在使用ActiveMQ时收到“Could not connect to broker URL”错误，该异常通常表明客户端无法建立到消息代理的网络连接。端口未开放是常见原因之一，但并非唯一可能。以下是多种可验证与修复的路径：
一、确认ActiveMQ服务进程是否已启动
该错误最基础的原因是Broker进程根本未运行，此时无论端口是否开放均无法连接。需检查服务实际状态而非仅依赖端口监听判断。
1、进入ActiveMQ安装目录下的bin子目录。
2、在Windows系统中执行activemq.bat start（或直接双击运行）；在Linux系统中执行./activemq start。
3、查看控制台输出或data/activemq.log日志文件，确认出现INFO | Apache ActiveMQ 字样。
4、若日志中存在Failed to start broker或Address already in use等提示，说明启动失败，需进一步排查配置或端口占用。
二、验证目标端口是否处于监听状态
即使服务启动成功，若配置的监听地址或端口与客户端URL不匹配，或被系统防火墙拦截，仍会触发该错误。需通过本地网络工具确认端口真实可达性。
1、在ActiveMQ服务器本机执行netstat -an | grep 61616（Linux/macOS）或netstat -ano | findstr :61616（Windows），确认存在LISTENING状态且绑定地址为0.0.0.0:61616或:::61616（IPv6通配）。
2、若仅绑定127.0.0.1:61616，则远程客户端无法访问，需修改conf/activemq.xml中bind属性为0.0.0.0。
3、在客户端机器执行telnet 192.168.200.130 61618（按实际IP和端口替换），若连接超时或拒绝，则说明网络层不通或端口未开放。
三、检查并开放对应协议端口的防火墙规则
ActiveMQ不同传输协议使用不同端口：默认tcp协议使用61616，nio协议常使用61618，stomp使用61613等。切换协议后若未同步更新防火墙策略，将导致连接失败。
1、确认客户端URL中使用的协议与端口一致，例如nio://192.168.200.130:61618对应端口61618。
2、在Linux服务器上执行firewall-cmd --list-ports，检查61618是否已在开放列表中。
3、如未开放，执行firewall-cmd --add-port=61618/tcp --permanent添加永久规则。
4、执行firewall-cmd --reload立即生效新规则。
5、Windows系统需在“高级安全Windows防火墙”中新建入站规则，允许TCP端口61618。
四、核对activemq.xml中是否启用对应协议的transportConnector
仅开放系统端口不足以让ActiveMQ响应请求，必须在配置文件中显式声明该协议的监听器，否则Broker不会绑定该端口。
1、打开conf/activemq.xml文件。
2、查找
3、若缺失该行，手动添加并确保name值唯一、uri中协议与端口与客户端URL完全一致。
4、保存文件后重启ActiveMQ服务使配置生效。
五、排除客户端URL地址与协议格式错误
连接URL书写错误会导致客户端尝试连接错误的服务端点，例如将管理控制台HTTP地址误用作JMS连接地址，或协议名拼写错误。
1、确认URL格式为协议://IP:端口，例如tcp://192.168.200.130:61616或nio://192.168.200.130:61618，而非http://192.168.200.130:8161。
2、检查代码中ActiveMQConnectionFactory构造参数或Spring配置中的brokerURL属性值。
3、避免在URL中混用localhost与真实IP：若服务运行在虚拟机中，客户端在宿主机，应使用虚拟机IP而非localhost或127.0.0.1。
4、若URL含查询参数（如?wireFormat.maxInactivityDuration=30000），需确保参数名及语法符合ActiveMQ版本文档要求。
