Docker容器中Go微服务连接本地RabbitMQ失败排查求助

环境与场景 #

• 本地以原生进程运行RabbitMQ，Go编写的微服务打包为Docker镜像运行
• 操作系统：macOS Ventura 13.3
• 本地PostgreSQL采用相同容器连接宿主机IP的方式可正常访问

连接配置与代码 #

Go微服务连接RabbitMQ的代码：

rmq_string := fmt.Sprintf("amqp://%s:%s@%s:%d/", conf.RabbitMQ.Username, conf.RabbitMQ.Password, conf.RabbitMQ.IP, conf.RabbitMQ.Port)

对应的TOML配置文件：

[RabbitMQ]
PORT = 5672
Username = "guest"
Password = "guest"
IP = "192.168.0.101"

容器运行命令 #

docker run \
  -p 8000:8081 \
  -v "$(pwd)/config.toml":/app/conf/config.toml \
  --name authentication \
  authentication

错误信息 #

time=2023-12-10T19:52:21.278Z level=INFO msg="RMQ connection string: amqp://guest:guest@192.168.0.101:5672/"
time=2023-12-10T19:52:21.279Z level=ERROR msg="could not connect to rabbitMQ: dial tcp 192.168.0.101:5672: connect: connection refused\n"

已排查情况 #

1. 本地原生运行微服务时，将配置IP改为localhost可正常连接RabbitMQ
2. 192.168.0.101是通过ipconfig getifaddr en0获取的本地en0网卡IP
3. 手动创建/usr/local/etc/rabbitmq/rabbitmq.config并配置监听5672端口，重启后无效：

[
  {rabbit, [
    {tcp_listeners, [5672]}
  ]}
].

4. 查看RabbitMQ日志/opt/homebrew/var/log/rabbitmq/rabbit@localhost.log，发现RabbitMQ仅监听回环地址：

2023-12-10 21:48:59.498721+02:00 [info] <0.683.0> started TCP listener on 127.0.0.1:5672
2023-12-10 21:48:59.540217+02:00 [info] <0.497.0> Server startup complete; 7 plugins started.
2023-12-10 21:48:59.540217+02:00 [info] <0.497.0>  * rabbitmq_mqtt
2023-12-10 21:48:59.540217+02:00 [info] <0.497.0>  * rabbitmq_stream
2023-12-10 21:48:59.540217+02:00 [info] <0.497.0>  * rabbitmq_stomp
2023-12-10 21:48:59.540217+02:00 [info] <0.497.0>  * rabbitmq_amqp1_0
2023-12-10 21:48:59.540217+02:00 [info] <0.497.0>  * rabbitmq_management
2023-12-10 21:48:59.540217+02:00 [info] <0.497.0>  * rabbitmq_management_agent
2023-12-10 21:48:59.540217+02:00 [info] <0.497.0>  * rabbitmq_web_dispatch
2023-12-10 21:48:59.686188+02:00 [info] <0.9.0> Time to start RabbitMQ: 2480127 us

问题原因 #

从日志可明确：RabbitMQ当前仅在**127.0.0.1（本地回环地址）**上监听5672端口，并未监听你的局域网IP（192.168.0.101）。这导致：

• 本地原生进程用localhost连接时，走回环地址可正常访问
• Docker容器属于独立网络环境，用192.168.0.101访问时，RabbitMQ未在该IP提供服务，因此连接被拒绝

另外，你手动创建的配置文件仅指定了监听端口，未指定监听IP，默认仅监听回环地址。

解决办法 #

方法一：修改RabbitMQ监听所有IP #

1. 找到正确的配置文件路径：Homebrew在M1/M2 Mac上默认将RabbitMQ安装到/opt/homebrew，配置文件路径为/opt/homebrew/etc/rabbitmq/rabbitmq.conf
2. 修改监听配置：编辑该文件，添加或修改以下内容：

listeners.tcp.default = 0.0.0.0:5672

0.0.0.0表示监听所有可用网络接口，包括回环地址和局域网IP
3. 重启RabbitMQ服务：

brew services restart rabbitmq

4. 验证监听状态：查看日志确认输出started TCP listener on 0.0.0.0:5672，或用命令检查：

lsof -i :5672

输出中应看到LISTEN状态的0.0.0.0:5672

方法二：使用Docker宿主机特殊地址（无需修改RabbitMQ配置） #

macOS上Docker提供了特殊地址host.docker.internal，用于容器访问宿主机。将配置文件中的IP改为该地址即可：

[RabbitMQ]
IP = "host.docker.internal"

此地址会映射到宿主机回环地址，RabbitMQ本来就在127.0.0.1监听，因此无需修改RabbitMQ配置。

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