控制器中避免HTTP请求504超时的解决方案（不修改配置）

首先得明确问题根源：你当前用的Net::HTTP是同步阻塞式的，当外部API响应时间超过服务器（比如Nginx、负载均衡）的超时阈值时，就会触发504错误。既然不想修改生产环境的全局超时配置，咱们可以从请求本身和处理逻辑入手，给你几个可行的解决方案：

1. 替换为非阻塞/带连接池的HTTP客户端 #

同步的Net::HTTP会死死占用Rails Worker直到请求完成，很容易触发服务器超时。换成支持异步或持久化连接的HTTP客户端，能让Worker在等待API响应时处理其他请求，避免被长时间阻塞。

比如用Faraday配合持久化连接：

def action1
  conn = Faraday.new(url: "https://example.com") do |faraday|
    faraday.adapter :net_http_persistent # 复用连接，减少握手耗时
    faraday.options.timeout = 30 # 自定义请求超时（根据API实际情况调整）
    faraday.options.open_timeout = 10
  end

  begin
    res = conn.post("/api")
    render json: res.body
  rescue Faraday::TimeoutError, Faraday::ConnectionFailed
    render json: { error: "请求超时，请稍后重试" }, status: 408
  end
end

或者用Typhoeus（基于libcurl，天生支持超时控制和并发）：

def action1
  request = Typhoeus::Request.new(
    "https://example.com/api",
    method: :post,
    timeout: 30, # 请求超时时间
    connecttimeout: 10
  )

  response = request.run
  if response.success?
    render json: response.body
  elsif response.timed_out?
    render json: { error: "请求超时" }, status: 408
  else
    render json: { error: "请求失败" }, status: response.code
  end
end

2. 将API请求异步化（适合非实时场景） #

如果你的业务允许不立即返回API结果，可以把长耗时的请求放到后台任务里，先给用户返回一个"处理中"的响应，之后再通过邮件、WebSocket或站内通知推送结果。

用Rails自带的Active Job实现：

# app/jobs/api_request_job.rb
class ApiRequestJob < ApplicationJob
  queue_as :default

  def perform(user_id)
    uri = URI("https://example.com/api")
    http = Net::HTTP.new(uri.host, uri.port)
    request = Net::HTTP::Post.new(uri.request_uri)
    res = http.request(request)
    
    # 把结果保存到数据库或者通知用户
    User.find(user_id).update(api_response: res.body)
  end
end

# 控制器中的action
def action1
  ApiRequestJob.perform_later(current_user.id)
  render json: { message: "请求已提交，结果稍后通知" }, status: 202
end

3. 给原生Net::HTTP添加超时控制和重试 #

如果你不想更换客户端，也可以直接给Net::HTTP设置超时参数，再加上重试逻辑，避免因为偶尔的网络波动导致超时：

def action1
  uri = URI("https://example.com/api")
  http = Net::HTTP.new(uri.host, uri.port)
  http.open_timeout = 10 # 连接超时
  http.read_timeout = 30 # 读取响应超时

  request = Net::HTTP::Post.new(uri.request_uri)
  
  begin
    res = http.request(request)
    render json: res.body
  rescue Net::OpenTimeout, Net::ReadTimeout
    # 最多重试2次，避免单次网络问题导致失败
    retry if (retry_count ||= 0) < 2
    render json: { error: "请求超时，已重试多次" }, status: 408
  rescue => e
    render json: { error: "请求失败: #{e.message}" }, status: 500
  end
end

为什么这些方法能解决504？ #

• 非阻塞客户端让Rails Worker不会被长时间占用，服务器能在超时阈值内完成响应处理；
• 异步处理把长耗时任务移出请求流程，从根源上避免触发服务器的超时机制；
• 自定义请求超时能让你在API响应过慢时主动终止请求，返回友好响应，而不是让服务器返回生硬的504。

内容的提问来源于stack exchange，提问作者bav ko ten