Rails测试环境中新增CSS代码无法编译加载是什么原因？

• 优先清理资产缓存与残留产物，执行命令：

  rails tmp:clear assets:clobber RAILS_ENV=test
  

  执行完成后重启测试服务再验证，测试环境默认会缓存已编译资产，旧CSS产物残留是该问题的最高发原因。
• 核对测试环境资产配置，打开config/environments/test.rb确认以下参数配置：
  • 确保config.assets.compile = true，允许实时编译未预编译的资产
  • 确保config.assets.debug = true，关闭资产合并压缩逻辑，避免旧合并产物覆盖新修改
  • 建议新增config.public_file_server.headers = { 'Cache-Control' => 'no-cache' }，禁用静态资源的缓存逻辑
• 检查外置CSS编译工具配置，如果你使用了tailwindcss-rails、cssbundling-rails、dartsass-rails这类独立于Rails原生资产管道的CSS编译工具：
  • 核对package.json中build:css相关脚本，确认测试环境下没有跳过CSS编译的逻辑，部分开发者会仅给开发环境配置CSS实时监听，测试环境仅读取上次预编译的产物
  • 手动执行一次全量CSS编译后再跑测试，对应命令通常为npm run build:css，可根据你使用的包管理器替换为yarn/pnpm的对应命令
• 排查Capybara与测试相关配置：
  • 确认Capybara.asset_host未指向固定的旧资源地址，避免测试请求拉取到其他环境的旧CSS
  • 检查spec/support目录下的自定义配置，确认没有修改资产加载路径、强制读取预编译CSS的逻辑
• 排查布局文件的CSS引入逻辑，打开app/views/layouts/application.html.erb，确认你修改的CSS文件对应的stylesheet_link_tag没有加Rails.env.development?这类条件判断，避免修改的CSS在测试环境根本没有被引入

内容的提问来源于stack exchange，提问作者raphael-allard