在Docker Swarm部署Eclipse Ditto时Nginx无法解析gateway服务问题

核心原因 #

Nginx启动速度快于gateway服务，启动阶段Swarm的服务发现还未完成gateway的注册，导致Nginx解析gateway主机名失败；此外需确认Swarm overlay网络的服务发现配置是否完全匹配。

解决方案 #

1. 给Nginx添加启动延迟 #

在Nginx服务的command中加入延迟命令，为Swarm服务发现留足注册时间：

services:
  nginx:
    # 其他原有配置...
    command: ["/bin/sh", "-c", "sleep 10 && nginx -g 'daemon off;'"]

2. 修改Nginx配置，增强DNS解析与重试机制 #

在nginx.conf的上游服务块中添加Docker内置DNS服务器配置及重试规则：

upstream gateway {
    server gateway:8080;
    resolver 127.0.0.11 valid=30s;
}

server {
    # 其他原有配置...
    location / {
        proxy_pass http://gateway;
        proxy_next_upstream error timeout invalid_header http_502 http_503 http_504;
        proxy_connect_timeout 5s;
        proxy_send_timeout 10s;
        proxy_read_timeout 10s;
    }
}

• 127.0.0.11是Docker内置DNS服务器地址，专门用于容器间服务解析
• valid=30s设置DNS缓存有效期，适配Swarm服务的动态变化
• proxy_next_upstream配置让Nginx遇到错误时自动重试上游服务

3. 确认Swarm网络配置正确性 #

• 确保gateway与nginx服务绑定同一个overlay网络，且网络配置允许服务间通信：

networks:
  ditto-network:
    driver: overlay
    attachable: true

services:
  gateway:
    networks:
      - ditto-network
  nginx:
    networks:
      - ditto-network

• 不要给服务自定义hostname字段，Swarm服务发现默认以服务名作为主机名，自定义hostname会干扰解析逻辑

4. 恢复健康检查并配置服务启动依赖（推荐） #

重新启用healthcheck，让Swarm确保gateway就绪后再启动nginx：

services:
  gateway:
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8080/health"]
      interval: 10s
      timeout: 5s
      retries: 3
      start_period: 30s
  nginx:
    depends_on:
      gateway:
        condition: service_healthy
    # 其他原有配置...

验证步骤 #

1. 重新部署堆栈：docker stack deploy -c docker-compose.yml ditto
2. 查看nginx日志：docker service logs ditto_nginx，确认无host not found错误
3. 通过Postman测试接口，检查响应是否正常

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