Connection refused错误说明TCP连接被目标主机主动拒绝,需依次排查服务状态、监听配置、防火墙、客户端参数及用户凭证:检查systemctl状态与ss端口监听;修改rabbitmq.conf绑定0.0.0.0:5672;ufw放行5672/tcp;改用addresses统一配置;启用management插件并创建远程用户。

如果您尝试连接 RabbitMQ 消息队列服务,但客户端持续报出 “Connection refused” 错误,则说明 TCP 连接在建立阶段即被目标主机主动拒绝。这通常意味着服务进程未监听对应端口、网络路径被拦截,或配置指向了错误地址。以下是多种可独立验证与执行的排查与修复方法:
一、确认 RabbitMQ 服务进程已运行并监听端口
该步骤用于验证 RabbitMQ 后台服务是否处于活动状态,且已正确绑定到 AMQP 默认端口(5672)或管理界面端口(15672)。若服务未启动或监听异常,所有外部连接请求均会被内核直接拒绝。
1、检查服务当前运行状态:
sudo systemctl status rabbitmq-server
2、若显示 inactive 或 failed,立即启动服务:
sudo systemctl start rabbitmq-server
3、强制重载配置并重启服务以确保变更生效:
sudo systemctl daemon-reload && sudo systemctl restart rabbitmq-server
4、验证端口监听情况:
sudo ss -tlnp | grep ':5672\|:15672'
5、若无任何输出,说明 RabbitMQ 未在指定端口监听,需进入后续配置检查环节。
二、检查并修正 RabbitMQ 监听地址与端口配置
RabbitMQ 默认仅绑定到 localhost(127.0.0.1),导致远程客户端无法访问。必须显式配置为监听 0.0.0.0 或具体网卡 IP,否则即使服务运行,连接也会被拒绝。
1、打开或创建主配置文件:
sudo nano /etc/rabbitmq/rabbitmq.conf
2、添加或修改以下监听配置(确保无注释且格式正确):
listeners.tcp.default = 0.0.0.0:5672
management.tcp.port = 15672
management.tcp.ip = 0.0.0.0
3、保存后重启服务:
sudo systemctl restart rabbitmq-server
4、再次执行 sudo ss -tlnp | grep :5672,确认输出中包含 0.0.0.0:5672 及 rabbitmq-server 进程名。
三、放行系统防火墙对 RabbitMQ 端口的访问
Ubuntu 系统默认启用 ufw 防火墙,若未显式允许 5672/15672 端口,入站连接将被静默丢弃,表现为 Connection refused。
1、查看当前防火墙规则:
sudo ufw status verbose
2、若状态为 Active,且未列出 5672 或 15672 端口,则执行放行:
sudo ufw allow 5672/tcp
sudo ufw allow 15672/tcp
3、重新加载规则:
sudo ufw reload
4、临时禁用防火墙进行交叉验证(测试后请恢复):
sudo ufw disable
四、验证客户端连接参数是否匹配服务端配置
Spring Boot 等框架在连接 RabbitMQ 集群时,旧式 host+port 分离配置易导致地址解析错误,例如生成 [192.168.1.1, 192.168.1.2:5672] 这类不一致连接列表,引发拒绝连接。
1、检查 application.yml 中 RabbitMQ 配置项:
❌ 错误写法:
rabbitmq:
host: 192.168.1.1,192.168.1.2
port: 5672
2、改为使用 addresses 统一指定完整地址:
✅ 正确写法:
rabbitmq:
addresses: 192.168.1.1:5672,192.168.1.2:5672
username: your_user
password: your_pass
3、若仅单节点部署,也应统一写为:
addresses: localhost:5672 或 192.168.1.1:5672
五、启用管理插件并创建有效用户凭证
部分安装方式默认禁用 Web 管理界面,且初始用户仅有 guest/guest(仅限 localhost 访问)。若客户端使用非本地地址连接且未创建授权用户,连接请求会在认证前被拒绝。
1、启用管理插件:
sudo rabbitmq-plugins enable rabbitmq_management
2、创建具备 administrator 标签的新用户:
sudo rabbitmqctl add_user admin strong_password
sudo rabbitmqctl set_user_tags admin administrator
sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"
3、使用新用户及密码更新客户端配置,并确保 VHost 为 /(默认)。
4、通过浏览器访问 http://:15672,使用 admin 登录验证服务可达性与权限有效性。











