如何让Faraday在收到202响应时自动重试POST请求？

别担心，这个需求完全可以通过Faraday官方的Faraday::Request::Retry中间件实现——你之前没成功是因为默认的重试逻辑只针对异常或5xx错误，咱们只需要调整配置，让它把202状态码也纳入重试触发条件就行，还能自定义重试次数、间隔策略。

下面是完整的实现示例：

方法一：使用官方Retry中间件（推荐） #

直接在Faraday客户端初始化时配置Retry中间件，重点是修改retry_if条件，同时开启retry_non_idempotent允许重试POST请求：

require 'faraday'

conn = Faraday.new(url: 'https://your-api-target.com') do |faraday|
  # 添加Retry中间件并配置参数
  faraday.request :retry,
    max: 5,                          # 最多重试5次（加上首次请求总共6次尝试）
    interval: 1,                     # 首次重试前等待1秒
    interval_randomness: 0.5,        # 每次等待时间允许±50%的随机波动（避免请求雪崩）
    backoff_factor: 2,               # 指数退避：每次等待时间乘2（1s → 2s →4s →8s →16s）
    retry_non_idempotent: true,      # 关键！允许重试POST这类非幂等请求（默认禁用）
    retry_if: ->(env, _error) {      # 触发重试的条件：响应状态码为202
      env.response&.status == 202
    },
    retry_block: ->(env, opts, retries, _err) {  # 可选：重试时的日志/自定义操作
      puts "[Faraday Retry] Attempt #{retries}/#{opts[:max]}: #{env.url} returned 202, retrying..."
    }

  # 别忘了添加你需要的其他中间件，比如json解析
  faraday.response :json
  faraday.adapter Faraday.default_adapter
end

# 测试POST请求
response = conn.post('/your-endpoint') do |req|
  req.body = { key: 'value' }.to_json
  req.headers['Content-Type'] = 'application/json'
end

参数说明： #

• max：设置最大重试次数，比如设为5的话，加上首次请求一共会尝试6次
• interval & backoff_factor：控制重试间隔，指数退避能有效减轻服务器压力
• retry_non_idempotent：必须开启，因为Faraday默认不会重试POST这类可能修改资源的请求
• retry_if：自定义触发重试的逻辑，这里直接检查响应状态码是否为202，不管有没有抛出错误

方法二：自定义中间件（如果需要更灵活的逻辑） #

如果官方Retry模块的配置满足不了你的特殊需求，也可以自己写一个简单的中间件：

class Retry202Middleware < Faraday::Middleware
  def initialize(app, max_retries: 5, interval: 1)
    super(app)
    @max_retries = max_retries
    @interval = interval
  end

  def call(env)
    retries = 0
    response = @app.call(env)

    while response.status == 202 && retries < @max_retries
      retries += 1
      sleep @interval * (2 ** (retries - 1)) # 指数退避
      puts "[Custom Retry] Attempt #{retries}/#{@max_retries}: Retrying POST to #{env.url}"
      response = @app.call(env)
    end

    response
  end
end

# 使用自定义中间件
conn = Faraday.new(url: 'https://your-api-target.com') do |faraday|
  faraday.use Retry202Middleware, max_retries: 5, interval: 1
  faraday.response :json
  faraday.adapter Faraday.default_adapter
end

这个自定义中间件会在收到202响应时自动重试，直到达到最大次数或收到其他状态码。

注意事项： #

• 202状态码的语义是"请求已接受，正在处理"，所以重试时一定要合理设置间隔和次数，避免对服务器造成过大压力
• 如果你的POST请求不是幂等的（比如重复提交会创建多个资源），要谨慎使用重试——不过既然你需要重试，应该已经确认了接口是安全可重试的

内容的提问来源于stack exchange，提问作者Yaroslav V.