Zuul+Ribbon配置MaxAutoRetries=3却重试8次的原因及解决

为什么会出现8次调用？ #

你的重试次数超出预期是因为Zuul自身重试机制与Ribbon重试机制叠加导致的：

1. 接口休眠3000ms，远大于配置的1000ms超时时间（ReadTimeout/socket-timeout-millis），触发超时重试条件。
2. 你同时开启了：
   • Zuul全局重试：zuul.retryable=true
   • Ribbon重试：spring.cloud.loadbalancer.retry.enabled=true + 配置了MaxAutoRetries=3
3. 次数计算：
   • Ribbon单次流程的总调用数：(MaxAutoRetries + 1) = 3+1=4（1次初始调用 + 3次重试）
   • Zuul会对整个Ribbon调用流程再执行一次重试，最终总调用数为4*2=8

如何设置为仅重试3次？ #

要实现“初始调用1次 + 重试3次”（总调用数4次），只需关闭Zuul层面的重试，保留Ribbon的重试配置即可：

修改YML配置 #

将zuul.retryable设为false：

spring:
  application:
    name: test-gateway
  cloud:
    loadbalancer:
      retry:
        enabled: true

zuul:
  retryable: false # 关闭Zuul自身重试，仅用Ribbon处理重试
  set-content-length: true
  routes:
    test:
      path: /**
      serviceId: TEST
      stripPrefix: false
      sensitiveHeaders: Cookie,Set-Cookie

  ribbon:
    eager-load:
      enabled: true
  include-debug-header: true
  host:
    connect-timeout-millis: 1000
    socket-timeout-millis: 1000

TEST:
  ribbon:
    ReadTimeout: 1000
    ConnectTimeout: 1000
    retryableStatusCodes: 500, 503, 502, 408
    MaxAutoRetriesNextServer: 0
    OkToRetryOnAllOperations: true
    MaxAutoRetries: 3

其他需要注意的Ribbon配置调整 #

• OkToRetryOnAllOperations：当前设为true会让Ribbon对所有HTTP方法（包括POST、PUT等非幂等请求）重试，若你的业务中有非幂等接口，建议改为false，避免重复提交数据。
• 重试次数的定义：Ribbon的MaxAutoRetries是同一服务器的重试次数，不包含初始调用，所以总调用数是MaxAutoRetries + 1，这是正常逻辑，符合你“重试3次”的需求。
• 超时配置一致性：你当前Zuul的host超时与Ribbon的超时配置一致，这是正确的，避免因层级超时不一致导致的额外重试触发。

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