如何让Rails停止返回Cache-Control: no-store响应头

以下是按优先级排序的排查及修复步骤：

1. 排查全局控制器回调逻辑 #

遗留项目大概率在父控制器中注入了强制无缓存的自定义逻辑，优先检查：

• ApplicationController或所有控制器继承的父控制器中，是否存在before_action/after_action回调调用了expires_now方法，或直接修改response.headers['Cache-Control']为你当前看到的no-store, must-revalidate, private, max-age=0无缓存值
• 是否全局调用了cache_control方法设置了no_store等无缓存属性

2. 检查框架默认响应头配置 #

Rails 5支持全局配置默认响应头，查看config/application.rb以及各运行环境的配置文件（config/environments/development.rb、config/environments/production.rb等），是否存在以下配置：

config.action_dispatch.default_headers['Cache-Control'] = 'no-store, must-revalidate, private, max-age=0'

如果存在，直接将值修改为业务需要的缓存规则即可，例如公开可缓存的内容可设置为public, max-age=3600。

3. 排查认证组件的默认规则 #

如果你使用了Devise等用户认证组件，这类组件默认会给所有已认证用户的响应强制添加无缓存头，避免敏感信息泄漏：

• Devise对应的逻辑是名为set_cache_header的after_action回调，可在需要开启缓存的控制器中按需跳过该回调：

skip_after_action :set_cache_header, only: [:index, :show]

• 也可全局重写该方法，自定义认证请求的缓存规则：

class ApplicationController < ActionController::Base
  def set_cache_header
    response.headers['Cache-Control'] = 'public, max-age=1800' # 按需调整参数
  end
end

4. 确认缓存配置生效范围 #

确保config.action_controller.perform_caching = true已经添加到所有运行环境的配置文件中，部分老旧项目会在单独的环境配置中覆写该值为false，导致全局配置不生效。

快速兜底方案 #

如果排查不到具体的注入逻辑，可直接在ApplicationController中添加全局回调强制覆盖所有请求的Cache-Control头，该方式优先级最高，不会被其他默认逻辑覆盖：

after_action do
  response.headers['Cache-Control'] = 'public, max-age=300' # 按业务需求调整缓存规则
end

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