Rails Admin线上提示rails_admin.css不在资产管道，预编译无效

问题根因 #

本地运行无异常是因为开发环境默认开启资产动态编译，会直接从gem源码路径读取Rails Admin的样式、脚本，不经过预编译流程。你当前配置的预编译规则没有产出目标文件，核心原因有两个：

• 配置里的*.css *.js通配符仅能匹配应用app/assets/stylesheets、app/assets/javascripts根目录下的散文件，不会递归扫描gem内子路径存放的Rails Admin专属资产
• 这种粗粒度的根目录文件匹配逻辑，完全覆盖不到rails_admin/rails_admin.css这类嵌套路径的资产文件，自然预编译阶段不会生成对应产物

修复操作步骤 #

1. 调整资产预编译配置
   打开config/initializers/assets.rb，删掉原有粗粒度的通配符规则，替换为明确指定路径的预编译配置：

Rails.application.config.assets.precompile += %w(
  rails_admin/rails_admin.css
  rails_admin/rails_admin.js
  ckeditor/*
)

注意：不要直接用无层级的全局通配符，这类写法在Sprockets预编译逻辑里不会跨目录匹配嵌套路径的资产。
2. 核查生产环境核心配置
检查config/environments/production.rb的配置项是否正确：

• 保持config.assets.compile = false为关闭状态，避免线上动态编译带来的性能损耗
• 确认config.public_file_server.enabled = true，保证应用能正常读取预编译输出到public目录下的静态文件

3. 清理缓存后重新执行预编译
   旧的预编译缓存很容易导致文件识别异常，按顺序执行以下操作：

• 执行rake assets:clobber清空旧的预编译资产文件
• 执行RAILS_ENV=production rake assets:precompile重新生成生产环境资产
• 验证产出结果：进入public/assets/rails_admin目录，确认存在带哈希后缀的Rails Admin样式、脚本文件

4. 排查部署链路漏配

• 若使用Rails 7及以上版本，确认没有被JS/CSS Bundling的默认配置覆盖Sprockets的资产加载路径，Rails Admin的资产默认通过Sprockets加载，不需要经过前端打包流程
• 检查部署流程配置，确认没有跳过资产预编译环节（例如Capistrano部署中关闭了内置的deploy:assets:precompile任务），否则哪怕本地配置正确，线上服务器也不会生成对应资产文件

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