Rails项目执行rake assets:precompile时出现LoadError: cannot load such file -- sassc问题的原因排查与解决方案咨询

让我来帮你拆解这个问题的核心原因，再一步步给出针对性的解决方案：

可能的原因 #

• 第三方gem的间接依赖残留：虽然你手动移除了sassc和sassc-rails，但某些依赖gem（比如你提到的pdfjs_viewer-rails，或者其他未注意到的间接依赖）的内部逻辑可能仍在调用Sprockets旧的sassc_processor，导致预编译时触发加载sassc的请求。开发环境能正常运行可能是因为加载顺序或初始化逻辑的差异，没触发这个处理器。
• Sprockets处理器未完全替换：dartsass-rails的处理器可能没有正确覆盖Sprockets默认注册的SassC处理器，预编译时旧处理器被优先调用，引发错误。
• 预编译环境配置差异：rake assets:precompile默认使用生产环境配置，而该环境下的assets设置可能没有完全适配Dart Sass，导致旧的处理器逻辑被触发。

解决方案 #

1. 先定位依赖sassc的源头 #

首先得搞清楚到底哪个gem在偷偷依赖sassc，执行以下命令：

# 如果sassc已被安装，查看反向依赖
bundle show --reverse-dependencies sassc

# 如果sassc没安装，用这个命令查找依赖链
bundle why sassc

找到依赖源后：

• 优先查看该gem是否有更新版本，已经适配Dart Sass或不再依赖sassc；
• 如果暂时无法更新，可尝试在Gemfile中排除sassc依赖（需确保不会破坏gem功能）：

  gem 'problematic-gem', exclude: ['sassc']
  

• 或者用bundle override强制指定兼容版本（过渡方案）：

  bundle override sassc do
    gem 'sassc', '~> 2.4.0' # 适配Ruby 3.1.x的稳定版本
  end
  

2. 强制Sprockets使用Dart Sass处理器 #

在config/initializers/assets.rb中添加配置，确保旧的SassC处理器被移除，Dart Sass处理器优先注册：

Rails.application.config.assets.configure do |env|
  # 移除旧的SassC相关MIME类型注册
  env.unregister_mime_type 'text/css'
  env.register_mime_type 'text/css', extensions: ['.css'], charset: 'utf-8'

  # 强制注册Dart Sass处理器
  env.register_preprocessor 'text/css', DartSass::Rails::SassProcessor
end

同时检查config/application.rb，移除旧的SassC配置，替换为Dart Sass的设置：

# 移除类似这样的旧配置
# config.sass.style = :compressed

# 替换为dartsass-rails的配置
config.dartsass.style = :compressed

3. 调整生产环境的预编译配置 #

打开config/environments/production.rb，确保以下配置正确：

# 禁用旧的CSS压缩器，Dart Sass会自行处理压缩
config.assets.css_compressor = nil

# 明确指定要编译的CSS文件，确保Dart Sass处理所有样式
config.dartsass.builds = { 'application.css' => 'application.css' }

然后带上环境变量重新执行预编译：

RAILS_ENV=production rake assets:precompile

4. 彻底清理缓存与依赖 #

有时候残留的缓存或gem文件会导致奇怪的加载问题，执行以下命令彻底清理：

# 清理Rails临时文件和assets缓存
rails tmp:clear
rake assets:clobber

# 清理未使用的gem
bundle clean --force

# 重新安装所有依赖
bundle install

# 再次尝试预编译
rake assets:precompile

5. 临时兼容方案（万不得已时） #

如果以上方法都无法解决，可临时在Gemfile中添加sassc依赖作为过渡，等后续找到依赖源并更新后再移除：

gem 'sassc', '~> 2.4.0'

执行bundle install后再尝试预编译。

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