Ruby版本升级后本地启动应用遇font-awesome-sprockets导入错误求助

DevOps 小满

2026-8-21

解决Ruby 2.7.6升级后font-awesome-sprockets导入失败问题

排查与修复步骤

核对font-awesome gem兼容性
Ruby版本升级后，旧版font-awesome gem可能适配性不足。修改Gemfile锁定兼容Ruby 2.7.x的版本，例如：
```
gem 'font-awesome-rails', '~> 4.7.0'
```
执行bundle install更新依赖后重启服务器。
调整导入语句与资产配置
部分font-awesome版本无需-sprockets后缀，将app/assets/stylesheets/application.scss中的导入行改为：
```
@import "font-awesome";
```
同时检查config/initializers/assets.rb，确保font-awesome资产被纳入预编译：
```
Rails.application.config.assets.precompile += %w( font-awesome.css )
```
彻底清理资产缓存
旧缓存可能导致路径识别错误，先执行清理命令：
```
rake assets:clobber
```
开发环境下可重新预编译资产（可选）：
```
rake assets:precompile RAILS_ENV=development
```
完成后重启服务器。
排查依赖冲突
Ruby升级可能引发相关gem的版本冲突，运行以下命令检查资产编译类gem（如sprockets、sass-rails）的兼容性：
```
bundle outdated
bundle audit
```
更新冲突gem到适配Ruby 2.7.6的版本后重新安装依赖。
确认资产加载顺序
确保application.scss中font-awesome的导入在依赖它的样式之前，同时检查layouts/application.html.erb里的stylesheet_link_tag路径配置正确，无重复或错误引用。