生产环境编译资源成功却显示旧资源？问题排查与解决

可能原因及对应解决步骤 #

• 浏览器缓存
  浏览器会默认缓存静态资源，即使服务器端已更新文件。解决方法：

  1. 强制刷新页面（Windows/Linux用Ctrl+F5，Mac用Command+Shift+R）
  2. 面向普通用户时，确保Rails开启资源指纹（config.assets.digest = true），让新资源带唯一哈希后缀，从根源避免浏览器误读缓存

• 服务器静态资源缓存
  Nginx、Apache等服务器可能配置了静态资源缓存策略，导致旧资源未被及时替换。解决方法：

  1. 检查服务器配置（比如Nginx的expires指令），临时关闭静态资源缓存做测试
  2. 重启服务器，清除服务器层面的缓存
  3. 优化配置：对带哈希指纹的资源设置长缓存，对HTML等动态页面设置短缓存或禁用缓存

• Rails资产管道配置异常
  未开启资源指纹或预编译不完整，会导致资源路径无法自动更新。解决方法：

  1. 确认config/environments/production.rb中config.assets.digest = true已启用
  2. 重新执行预编译命令：rake assets:precompile RAILS_ENV=production
  3. 删除public/assets目录下的旧无指纹资源，只保留带哈希后缀的新资源

• CDN缓存
  使用CDN时，CDN节点可能缓存了旧资源副本。解决方法：

  1. 手动刷新CDN的资源缓存
  2. 配置CDN根据文件哈希自动识别新资源，避免缓存未更新的内容

• 模板硬编码资源路径
  若视图模板中直接写死资源路径（如/assets/style.css），而非使用Rails辅助方法（stylesheet_link_tag 'style'），会导致无法引用带指纹的新资源。解决方法：

  1. 检查所有视图模板，替换硬编码路径为Rails提供的资源辅助方法
  2. 重启应用服务器，确保模板更新生效

• 应用服务器进程缓存
  Passenger、Puma等应用服务器可能在启动时缓存了旧的资源映射关系。解决方法：

  1. 重启应用服务器进程（Passenger执行passenger restart，Puma重启对应服务）

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