Rails 7移除sassc后提示cannot load such file -- sassc报错如何解决

核心原因 #

Sprockets 4.x 会根据项目内样式文件的后缀自动匹配对应处理器，只要环境中存在任意.scss/.sass文件、残留的处理器配置或旧缓存，就会主动尝试加载sassc库，和是否回滚application.css后缀没有直接关系。

按顺序执行以下排查修复步骤 #

• 确认gem彻底移除
  执行以下命令确认当前环境没有安装sassc相关gem：

  bundle list | grep sassc
  

  如果有输出，检查Gemfile里是否有遗漏的sassc、sassc-rails、rails-sassc相关条目，删除后重新执行bundle install，再执行bundle clean --force清理所有不在当前Gemfile依赖内的旧gem包。
• 清理所有残留的scss/sass文件
  全量扫描资产目录下的所有样式文件，找到所有后缀为.scss、.sass、.css.scss、.css.sass的文件：

  find app/assets vendor/assets -type f \( -name "*.scss" -o -name "*.sass" -o -name "*.css.scss" -o -name "*.css.sass" \)
  

  这类文件只要存在任意一个，Sprockets就会自动触发sassc加载逻辑。将这些文件全部改回.css后缀，确认不需要的文件直接删除，不要遗漏子目录下的残留模板文件。同时确认app/assets/stylesheets/application.css后缀正确，没有被误标记为scss格式。
• 清除所有本地缓存
  Bootsnap的加载路径缓存、Sprockets的资产编译缓存都会保留之前的sassc加载记录，哪怕代码修改完成也会读取旧缓存触发报错，停止本地Rails服务后执行以下命令彻底清缓存：

  rm -rf tmp/cache/assets
  rm -rf tmp/bootsnap*
  bin/rails assets:clobber
  

• 检查配置残留
  逐行检查以下配置文件，删除所有和sass/sassc相关的配置项：
  • config/application.rb：确认除了你已经添加的config.assets.css_compressor = nil之外，没有其他指定sassc作为CSS压缩器、处理器的配置
  • config/initializers/assets.rb：删除所有手动注册SasscProcessor、配置scss编译规则的代码
  • config/environments/development.rb/production.rb：检查环境级别的资产配置，没有指定sass相关的压缩、处理规则
• 验证修复结果
  执行以下命令验证配置是否生效：

  bin/rails runner "
  puts 'CSS Compressor: ' + Rails.application.config.assets.css_compressor.inspect
  begin
    Sprockets::SasscProcessor.instance
    puts 'WARN: Sassc processor still active'
  rescue LoadError
    puts 'OK: Sassc processor not loaded'
  end
  "
  

  输出CSS Compressor: nil和OK: Sassc processor not loaded即代表配置正确，重启Rails服务即可恢复正常。

特殊场景排查 #

如果以上步骤执行后仍然报错，检查app/assets/builds目录（Tailwind CSS默认编译输出目录）下是否有残留的scss文件，同时检查config.assets.precompile配置项里是否存在指定scss后缀的预编译条目，移除对应条目即可。

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