docker-compose部署NestCloud微服务Consul连接被拒绝问题求助

核心问题定位 #

报错consul: kv.get: connect ECONNREFUSED 127.0.0.1:8500说明微服务当前请求的是自身容器内的8500端口，而Consul服务运行在独立容器中，没有部署在微服务容器本地，所以连接被拒绝。你可以ping通Consul容器说明容器网络互通正常，问题出在Consul地址配置错误。

排查步骤 #

• 检查NestCloud的bootstrap-development.yaml配置文件中Consul的host配置项，确认是否写死了127.0.0.1或者localhost
• 检查docker-compose.yaml中Consul服务的容器名配置，确认微服务与Consul在同一个compose默认网络下
• 检查Consul容器启动参数，是否配置了仅绑定环回地址、未开放外部访问权限

具体解决方案 #

1. 修改NestCloud配置文件 #

将bootstrap-development.yaml中Consul的host地址替换为docker-compose里Consul服务的服务名，示例配置如下：

consul:
  host: consul # 此处替换为docker-compose中定义的consul服务的实际名称
  port: 8500
  # 其余原有配置保持不变

2. 修正docker-compose.yaml配置 #

• 确保Consul服务启动参数配置了-client 0.0.0.0，允许其他容器访问，参考配置：

services:
  consul:
    image: consul:latest
    ports:
      - "8500:8500"
    command: agent -dev -client 0.0.0.0 -ui # -client 0.0.0.0为必填参数
  test-service:
    build: ./test-service
    depends_on:
      - consul
    # 其余原有配置保持不变

3. 多环境适配方案（可选） #

如果需要同时兼容本地开发和容器部署，可通过环境变量注入Consul地址：

# bootstrap-development.yaml 配置
consul:
  host: ${CONSUL_HOST:127.0.0.1}
  port: ${CONSUL_PORT:8500}

# docker-compose.yaml 中test-service新增环境变量配置
services:
  test-service:
    environment:
      CONSUL_HOST: consul
      CONSUL_PORT: 8500

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