Rails调用外部API缓存优化：避免频繁请求消耗配额

嘿，这个需求太接地气了——既不想给外部API服务器添不必要的负载，又能省配额，完全合理！咱用Ruby on Rails来实现的话，结合缓存和请求计数器就能搞定，逻辑清晰还符合Rails的最佳实践。

核心思路 #

简单来说就是：

• 用缓存存储外部API的响应结果
• 维护一个请求计数器，每累计到100次请求时，重新调用API更新缓存并重置计数器
• 非第100次请求时，直接返回缓存内容，同时把计数器加1

具体实现步骤 #

1. 配置缓存存储（推荐用Redis） #

Rails默认支持多种缓存后端，Redis最适合这种需要原子计数的场景——它的INCR命令能保证计数器操作的原子性，不会出现并发请求下的计数混乱。如果还没配置Redis，只需在config/environments/production.rb里添加：

config.cache_store = :redis_cache_store, { url: ENV['REDIS_URL'] }

2. 封装API服务类（别在View里写逻辑！） #

把API调用和缓存逻辑封装到服务类里，代码更整洁也方便维护。创建app/services/external_api_service.rb：

class ExternalApiService
  CACHE_KEY = "external_api_response"
  COUNTER_KEY = "external_api_request_counter"
  REFRESH_THRESHOLD = 100

  def self.get_response
    # 原子递增计数器，不存在则初始化为0
    current_count = Rails.cache.increment(COUNTER_KEY, 1, initial: 0)

    # 判断是否需要刷新缓存
    if current_count >= REFRESH_THRESHOLD
      # 调用外部API获取最新数据
      fresh_response = fetch_external_api
      # 更新缓存，加个过期时间兜底（防止计数器失效时缓存一直不更新）
      Rails.cache.write(CACHE_KEY, fresh_response, expires_in: 1.hour)
      # 重置计数器
      Rails.cache.delete(COUNTER_KEY)
      fresh_response
    else
      # 优先取缓存，缓存为空时先调用API初始化
      Rails.cache.fetch(CACHE_KEY) do
        fetch_external_api
      end
    end
  end

  private

  def self.fetch_external_api
    # 这里替换成你的实际API调用逻辑，比如用Faraday/HTTParty
    response = HTTParty.get("https://your-external-api-url.com/data")
    response.parsed_response # 返回解析后的响应数据
  rescue StandardError => e
    # API调用失败时，返回旧缓存或默认值，避免影响用户体验
    Rails.logger.error("External API call failed: #{e.message}")
    Rails.cache.read(CACHE_KEY) || { msg: "暂时无法获取数据，请稍后再试" }
  end
end

3. 在Controller/View里调用服务类 #

比如在控制器里：

class HomeController < ApplicationController
  def index
    @api_data = ExternalApiService.get_response
  end
end

之后在View里直接用@api_data渲染数据就好啦。

关键注意点 #

• 并发安全：用Redis的INCR做计数是原子操作，能避免多个请求同时触发API调用的问题，这点一定要重视！
• 异常兜底：给缓存加过期时间、API调用失败时返回旧缓存，能保证用户始终能拿到可用数据
• 本地调试：如果想测试刷新逻辑，可以手动删除缓存和计数器：Rails.cache.delete("external_api_response")和Rails.cache.delete("external_api_request_counter")

这样就能完美实现你要的“每100次请求调用一次API，其余用缓存”的需求，既省配额又减轻了API服务器压力～

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