RabbitMQ连接错误深度解析：解决“目标计算机主动拒绝”问题

落敏姑娘_1011

发布时间：2025-12-04 12:17:00

438人浏览过

来源于php中文网

原创

RabbitMQ连接错误深度解析：解决“目标计算机主动拒绝”问题

本文深入解析rabbitmq连接时常见的“目标计算机主动拒绝”错误（winerror 10061）。该错误通常发生在tcp连接握手阶段，与rabbitmq服务未运行、监听地址配置不当或防火墙阻断有关。教程提供了详细的诊断步骤，包括使用telnet和netstat工具检查端口状态、审查rabbitmq配置和日志，以及排查防火墙设置，帮助开发者高效解决连接问题。

在开发或部署使用RabbitMQ作为消息代理的应用程序（如Celery）时，开发者可能会遇到“连接被目标计算机主动拒绝”的错误（[WinError 10061] No connection could be made because the target machine actively refused it）。这个错误表明客户端无法与RabbitMQ服务器建立基本的网络连接。本教程将深入探讨此错误的原因，并提供一套系统的诊断和排查方法。

理解“连接被目标计算机主动拒绝”错误

当客户端尝试连接到RabbitMQ服务器时，它首先会尝试建立一个TCP连接。这个过程涉及一个标准的三次握手。如果服务器端没有在指定的IP地址和端口上监听，或者由于某种原因拒绝了连接请求，客户端就会收到“连接被目标计算机主动拒绝”的错误。

核心要点：

TCP握手失败：此错误发生在TCP连接层，意味着客户端的SYN请求没有得到服务器的SYN-ACK响应，而是收到了一个RST（Reset）包，或者网络防火墙返回了ICMP“管理禁止”消息。
与认证无关：请注意，这个错误发生在任何应用层协议（如AMQP）或认证（用户名、密码）之前。如果连接被拒绝，那么讨论用户凭证或VHost配置尚为时过早。

常见原因分析

导致“连接被目标计算机主动拒绝”错误的主要原因通常有以下几点：

RabbitMQ服务未运行：这是最直接也最常见的原因。如果RabbitMQ服务器进程没有启动，或者在启动过程中遇到错误而退出，它就无法监听任何端口。
RabbitMQ监听地址或端口配置错误：
- RabbitMQ可能被配置为只监听特定的IP地址（例如，10.0.0.7），而客户端尝试连接的是另一个地址（例如，127.0.0.1或localhost）。
- RabbitMQ监听了非默认的端口，而客户端仍尝试连接默认的5672端口。
防火墙阻断：
- 操作系统防火墙：服务器操作系统（如Windows Defender Firewall、Linux的iptables或firewalld）可能阻止了对5672端口的入站连接。
- 网络防火墙：如果客户端和服务器位于不同的网络中，中间的网络设备（如路由器、硬件防火墙）可能阻止了5672端口的流量。

诊断与排查步骤

解决此问题需要系统地检查服务器端的运行状态、网络配置和防火墙规则。

1. 验证RabbitMQ服务状态与端口监听

首先，我们需要确认RabbitMQ服务是否正在运行，并且正在监听客户端尝试连接的IP地址和端口。

使用 telnet 或 nc 进行端口连通性测试 这是最快速、最直接的验证方式。在客户端或服务器上执行以下命令，尝试连接RabbitMQ的端口（默认为5672）。
```
# 在Windows或Linux/macOS上
telnet 127.0.0.1 5672
```
预期结果：

windows-auto
Windows 桌面自动化技能，支持鼠标控制（移动/点击/拖拽/滚轮/截图）、键盘输入（文字输入/按键/组合键）、窗口管理（查找/聚焦/最大化/最小化/关闭/移动）、截图并发送文件。提供两种截图方式：Python pyautogui 截图（集成在自动化流程中）和 PowerShell + .NET 零依赖截图（支持区域截图和多显示器）。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。

下载
- 连接被拒绝：如果看到 Trying 127.0.0.1... telnet: connect to address 127.0.0.1: Connection refused 或类似信息，则表明目标端口未开放或服务未监听，这与错误信息吻合。
- 连接成功：如果屏幕变黑或显示一些AMQP协议的握手信息（例如 AMQP 字符），则说明TCP连接已成功建立，问题可能出在RabbitMQ配置或客户端认证上，但不太可能是“连接被主动拒绝”的错误。
在Linux/macOS上，也可以使用 nc (netcat) 命令进行测试：
```
nc -zv 127.0.0.1 5672
```
使用 netstat 检查端口监听情况 在RabbitMQ服务器上执行 netstat -an 命令，可以列出所有活动的TCP连接和监听端口。检查是否有进程在监听5672端口。
```
# 在Windows上
netstat -an | findstr "5672"

# 在Linux/macOS上
netstat -an | grep "5672"
```
预期结果：
- 如果RabbitMQ服务正常运行并监听在默认端口，您应该会看到类似 TCP 0.0.0.0:5672 0.0.0.0:0 LISTENING 或 TCP 127.0.0.1:5672 0.0.0.0:0 LISTENING 的条目。
  - 0.0.0.0 表示RabbitMQ正在监听所有可用网络接口上的5672端口。
  - 127.0.0.1 表示RabbitMQ只监听本地回环地址。
- 如果没有找到任何关于5672端口的 LISTENING 条目，则服务可能未运行，或者监听了不同的IP地址或端口。

2. 检查RabbitMQ配置

如果 netstat 没有显示5672端口处于监听状态，或者监听的IP地址不正确，您需要检查RabbitMQ的配置文件。

确认监听地址 RabbitMQ的配置文件（通常是 rabbitmq.conf 或 advanced.config）中，listeners.tcp.default 参数定义了RabbitMQ监听的TCP端口。确保其配置正确，并且没有限制只监听特定的非回环地址。
- 默认行为：如果未明确配置，RabbitMQ通常会监听所有可用接口的5672端口。
- 示例配置：
```
# rabbitmq.conf 示例
listeners.tcp.default = 5672
```
  或者，如果需要指定监听的IP地址：
```
listeners.tcp.1 = 127.0.0.1:5672
listeners.tcp.2 = 192.168.1.100:5672
```
- 请确保客户端连接的IP地址与RabbitMQ实际监听的地址匹配。
服务启动脚本或环境变量 检查RabbitMQ的服务启动脚本或环境变量，确认是否有任何配置覆盖了默认的监听设置。

3. 检查防火墙设置

防火墙是常见的连接阻断原因之一。

操作系统防火墙
- Windows：打开“Windows Defender 防火墙”设置，检查“入站规则”，确保5672端口允许TCP连接。
- Linux：
  - 对于使用 ufw 的系统（如Ubuntu）：
```
sudo ufw status
sudo ufw allow 5672/tcp
```
  - 对于使用 firewalld 的系统（如CentOS/RHEL）：
```
sudo firewall-cmd --list-all
sudo firewall-cmd --zone=public --add-port=5672/tcp --permanent
sudo firewall-cmd --reload
```
  - 对于使用 iptables 的系统：检查 iptables -L 输出，确保没有规则阻止5672端口。
网络防火墙 如果RabbitMQ服务器和客户端位于不同的物理或虚拟网络中，请检查中间的网络设备（如路由器、硬件防火墙）是否阻止了5672端口的流量。可能需要网络管理员的协助。

4. 审查RabbitMQ日志

RabbitMQ服务器的日志文件是诊断启动失败或配置错误的关键信息来源。

日志文件位置：
- Linux：通常在 /var/log/rabbitmq/ 目录下。
- Windows：通常在 %APPDATA%\RabbitMQ\log\ 目录下。
查找错误信息：仔细查看日志文件，特别是启动阶段的日志，查找任何与端口绑定失败、配置解析错误或服务启动异常相关的错误消息。
提高日志级别：在某些情况下，可能需要临时提高RabbitMQ的日志级别（例如，通过 rabbitmqctl set_log_level 命令）以获取更详细的诊断信息。

总结与注意事项

解决“连接被目标计算机主动拒绝”错误通常是一个系统性的排查过程。请遵循以下优先级：

确认RabbitMQ服务是否正在运行。
确认RabbitMQ服务是否监听了正确的IP地址和端口（通过 netstat 验证）。
确认是否有防火墙阻断了连接。
最后才考虑客户端的连接字符串是否正确（IP、端口）。

重要提示：

凭证无关：再次强调，此错误与用户名、密码或VHost等认证授权信息无关，因为连接在建立TCP会话之前就被拒绝了。
客户端配置：虽然问题根源不在服务器端，但仍需确保客户端（如Celery）配置的RabbitMQ连接地址（amqp://user:pass@host:port/vhost）中的 host 和 port 与RabbitMQ实际监听的地址和端口一致。

通过上述详细的诊断步骤，您应该能够定位并解决RabbitMQ连接中遇到的“目标计算机主动拒绝”问题，确保您的应用程序能够顺利地与消息队列进行通信。

Linux 中怎么使用 Iperf 测试服务器带宽性能

Linux 系统中怎么为新硬盘分区并挂载文件系统

Linux 系统中怎么在 firewalld 中将指定 IP 加入白名单放行

Linux 中怎么修改用户的登录 Shell 类型

Linux 系统中怎么为生产环境中的堡垒机配置不可篡改的审计日志