Rails7执行rails g spina:install时提示Mobility未配置报错

该报错属于典型的Rails引擎加载顺序冲突：Spina CMS的安装生成器执行时，会提前加载Spina::Resource模型，该模型依赖Mobility的翻译配置方法，但此时Mobility的初始化配置文件还未被生成、加载，直接触发未配置异常中断安装流程，该问题在Rails 7.0 + Spina 2.x + Mobility 1.2.x的组合中复现概率极高。

• 校验Gemfile中依赖声明顺序与版本匹配性：确认mobility版本≥1.2.9，且mobility的声明位置在spina之前，不存在版本锁冲突
• 检查初始化目录：确认config/initializers路径下是否存在mobility.rb配置文件，不存在则说明Mobility还未完成初始化配置
• 校验Rails自动加载配置：确认开发环境下是否开启了提前预加载（eager_load），导致模型在初始化流程前被加载
• 核对生成器执行日志：确认报错触发时Spina生成器还未执行到Mobility配置生成步骤，属于顺序问题而非依赖损坏

1. 预生成Mobility初始化配置
   直接先执行Mobility官方提供的安装生成器，提前生成配置文件完成初始化，再执行Spina安装：

   # 先安装Mobility配置
   rails g mobility:install
   # 执行完成确认config/initializers/mobility.rb存在后，再执行Spina安装
   rails g spina:install
   

   90%以上的同类型报错通过该步骤即可解决。
2. 锁定依赖版本与加载顺序
   调整Gemfile中的依赖声明顺序，避免Bundler加载时Spina先于Mobility被引入，同时锁定兼容版本：

   # Gemfile中确保mobility写在spina之前
   gem "mobility", "~> 1.2.9"
   gem "spina"
   

   修改完成后执行bundle install更新依赖锁，再重新执行安装命令。
3. 手动强制提前初始化Mobility
   上述方案无效时，在应用配置中添加初始化钩子，确保Spina模型加载前Mobility已完成配置：
   打开config/application.rb，在应用类的配置块中添加以下内容：

   config.after_initialize do
     next unless defined?(Mobility) && !Mobility.initialized?
     Mobility.configure do |config|
       config.default_backend = :jsonb
       config.accessor_method = :translates
       config.query_method    = :i18n
       config.default_options[:fallbacks] = { i18n: true }
     end
   end
   

   保存后重新执行安装命令即可。
4. 临时关闭开发环境预加载
   如果项目开启了Zeitwerk严格模式+开发环境eager_load，会导致所有模型在应用启动时就被加载，临时调整开发环境配置：

   # config/environments/development.rb
   config.eager_load = false
   

   等Spina安装完成、所有迁移执行完毕后，再根据项目性能需要调整该配置。

安装完成后记得执行rails db:migrate完成数据库表创建，重启Rails服务后即可通过/admin路径访问Spina后台。

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