Rails引擎引入样式表报Sprockets::AssetNotFound错误的解决方法

错误原因 #

1. Sprockets未扫描到自定义资产目录：你的样式文件存放在webjinny/app/apps/themes/default_theme/assets/css/default.css，但Sprockets默认仅识别app/assets、lib/assets、vendor/assets目录，未将themes目录加入扫描路径的话，它无法定位到该文件。
2. 引用路径与Sprockets识别路径不匹配：即便添加了路径，若视图中stylesheet_link_tag的路径和Sprockets对文件的映射路径不一致，仍会触发找不到资产的错误。
3. 预编译规则配置不准确：如果预编译的路径与实际文件的映射路径不符，生产环境下文件不会被预编译，直接报错。

正确配置与引入方式 #

1. 修正Engine的资产路径配置 #

打开webjinny/lib/webjinny/engine.rb，添加初始化代码让Sprockets扫描到主题资产：

module Webjinny
  class Engine < ::Rails::Engine
    # 将主题根目录加入Sprockets扫描路径
    initializer 'webjinny.theme_assets' do |app|
      app.config.assets.paths << root.join('app', 'apps', 'themes')
    end

    # 配置预编译规则，确保目标CSS被处理
    initializer 'webjinny.precompile_theme_css' do |app|
      # 预编译指定的主题样式文件
      app.config.assets.precompile += %w( default_theme/css/default.css )
      # 若支持多主题，可使用通配符简化配置：
      # app.config.assets.precompile += %w( */css/*.css )
    end
  end
end

将themes目录加入路径后，Sprockets会自动把themes/default_theme/assets视为合法资产源目录，其中的css/default.css会被映射为default_theme/css/default.css，与视图中的引用路径对应。

2. 修正视图中的样式引用 #

确保default_theme.html.erb里的stylesheet_link_tag路径正确：

<%= stylesheet_link_tag 'default_theme/css/default.css', media: 'all' %>

3. 验证资产是否可被识别 #

启动Rails控制台，执行以下命令确认资产能被找到：

Rails.application.assets.find_asset('default_theme/css/default.css')

返回Asset对象则说明配置正确；若返回nil，检查路径拼写或配置是否有误。

4. 生产环境预编译资产 #

部署前必须执行预编译命令，确保文件生成到public/assets目录：

rails assets:precompile

额外提示 #

• 若使用Rails 6+的Webpacker或jsbundling-rails，需确认自定义样式仍通过Sprockets处理，避免资产管道冲突。
• 尽量避免资产目录嵌套过深，保持Sprockets能直接识别assets下的子结构。
• 如需动态切换多主题，可编写辅助方法，根据当前主题生成对应的资产路径。

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