Traefik优雅停机配置咨询：部署更新时出现Bad Gateway响应

要解决部署更新时的Bad Gateway问题，核心是让Traefik在服务实例启停时平滑切换流量，同时确保后端服务能优雅处理请求收尾。以下是具体配置步骤：

一、后端服务必须支持优雅停机 #

• 确保你的应用能捕获SIGTERM信号，收到信号后停止接收新请求，等待当前所有正在处理的请求完成后再退出。不同语言框架有对应的实现方式（比如Node.js的process.on('SIGTERM')、Spring Boot的@PreDestroy）。
• 为应用添加健康检查接口（比如/health），接口需返回200状态码表示服务就绪，非200表示服务不可用。

二、Traefik 核心配置 #

1. 启用后端服务健康检查 #

在Traefik的动态配置中为服务添加健康检查规则，让Traefik能主动识别实例状态：

• Docker环境（通过标签配置）：

  labels:
    # 配置健康检查路径
    - "traefik.http.services.my-service.loadbalancer.healthcheck.path=/health"
    # 检查间隔
    - "traefik.http.services.my-service.loadbalancer.healthcheck.interval=5s"
    # 超时时间
    - "traefik.http.services.my-service.loadbalancer.healthcheck.timeout=2s"
    # 连续失败多少次判定为不健康
    - "traefik.http.services.my-service.loadbalancer.healthcheck.failurethreshold=3"
  

• File Provider 环境：

  [http.services.my-service.loadBalancer.healthCheck]
    path = "/health"
    interval = "5s"
    timeout = "2s"
    failureThreshold = 3
  

  健康检查失败的实例会被Traefik从负载均衡池中移除，不会再接收流量。

2. 配置Traefik自身的优雅停机 #

通过静态配置参数，让Traefik在收到停机信号后，等待一段时间再关闭EntryPoint，确保正在处理的请求完成：

# 启动Traefik时添加参数，设置关闭延迟10秒
traefik --entrypoints.web.shutdownDelay=10s

如果用配置文件（比如traefik.toml）：

[entryPoints.web]
  address = ":80"
  [entryPoints.web.shutdownDelay]
    duration = "10s"

三、部署流程配合 #

• Docker Swarm：配置滚动更新策略，确保新实例就绪后再终止旧实例：

  deploy:
    update_config:
      # 每次更新1个实例
      parallelism: 1
      # 实例更新间隔
      delay: 10s
      # 更新失败回滚
      failure_action: rollback
      # 监控实例就绪状态的时间
      monitor: 30s
  

• Kubernetes：设置Pod的terminationGracePeriodSeconds，配合Traefik的健康检查，让Kubernetes等待服务优雅退出后再销毁Pod：

  spec:
    terminationGracePeriodSeconds: 30
    containers:
    - name: my-app
      livenessProbe:
        httpGet:
          path: /health
          port: 8080
        initialDelaySeconds: 5
        periodSeconds: 5
      readinessProbe:
        httpGet:
          path: /health
          port: 8080
        initialDelaySeconds: 5
        periodSeconds: 5
  

常见问题排查 #

Bad Gateway通常是因为旧实例被直接杀死，Traefik还在转发流量到已关闭的实例，此时需检查：

1. 后端服务是否正确处理SIGTERM信号
2. Traefik是否配置了健康检查
3. 部署更新策略是否为滚动更新，且等待新实例就绪后再终止旧实例

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