Zuul + Ribbon重试问题：maxAutoRetries不生效，仅重试一次

我明白你调试了很久却找不到Ribbon只重试一次的原因，结合你描述的场景（Node服务在localhost:9080按200、500、500循环返回响应，Zuul路由配置），咱们从几个关键方向逐一排查：

1. 补全并验证Ribbon核心重试配置 #

你给出的application.yaml配置不完整，仅设置Zuul路由的retryable: true只是开启了Zuul层面的重试开关，Ribbon本身的重试参数才是控制重试次数的核心。需要针对目标服务补充完整配置：

# 针对foo服务的Ribbon重试配置
foo:
  ribbon:
    # 同一实例的重试次数（不含首次请求）
    MaxAutoRetries: 2
    # 切换其他实例的重试次数
    MaxAutoRetriesNextServer: 1
    # 是否允许对所有HTTP方法重试
    OkToRetryOnAllOperations: true
    # 指定需要触发重试的HTTP状态码
    retryableStatusCodes: 500

# 针对bar服务的Ribbon重试配置
bar:
  ribbon:
    MaxAutoRetries: 2
    MaxAutoRetriesNextServer: 1
    OkToRetryOnAllOperations: true
    retryableStatusCodes: 500

zuul:
  hosts:
    connect-timeout-millis: 1000
    socket-timeout-millis: 2000
  routes:
    foo:
      path: /foo/*
      serviceId: foo
      retryable: true
    bar:
      path: /foo/*/bar/
      serviceId: bar
      retryable: true
  # 全局开启Zuul重试（确保单个路由的重试配置生效）
  retryable: true

2. 检查版本兼容性问题 #

如果你的Spring Cloud版本较旧，可能存在Zuul与Ribbon重试逻辑的兼容性冲突：

• 部分旧版本中，Zuul的全局重试开关zuul.retryable默认关闭，即使单个路由设置retryable: true也无法触发多次重试
• 某些版本的Ribbon会忽略retryableStatusCodes配置，仅对连接超时、读取超时这类异常重试，不会对500状态码重试

3. 验证Node服务的响应是否符合重试触发条件 #

你需要确认：

• Node服务返回的500状态码是否在Ribbon的retryableStatusCodes配置范围内
• 服务返回500的时间是否在Zuul设置的socket-timeout-millis: 2000ms以内，如果超时会被Zuul直接拦截，不会触发Ribbon重试
• 可以在Node服务中打印每一次请求的日志，确认Ribbon实际发起的请求次数（比如是否只发了2次：首次+1次重试）

4. 排查自定义重试逻辑的干扰 #

如果项目中存在自定义的RetryHandler或RibbonRetryPolicy Bean，可能会覆盖默认的重试次数规则。检查代码中是否有类似自定义逻辑，确保它没有限制重试次数。

最后推荐的调试手段 #

开启Ribbon和Zuul的DEBUG日志，能清晰看到重试触发的全过程：

logging:
  level:
    com.netflix.ribbon: DEBUG
    org.springframework.cloud.netflix.zuul: DEBUG

通过日志可以明确看到Ribbon是否触发了重试、每次重试的原因，以及请求的目标实例，快速定位问题所在。

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