全新安装Solidus后访问后台页面出现未初始化常量错误

• 环境配置：
  • Ruby版本：ruby 3.2.2 (2023-03-30 revision e51014f9c0) [x86_64-linux]
  • Rails版本：Rails 7.0.5
  • 运行环境：WSL Ubuntu / Windows
• 操作流程：

  rails new my_store
  bundle add solidus
  bin/rails g solidus:install
  bin/rails s
  

• 异常表现：前端商店可正常访问、查看默认产品，但访问后台登录页http://127.0.0.1:3000/admin/login时，抛出错误：未初始化常量Spree::Admin::UserSessionsController

1. 验证Solidus与Rails版本兼容性 #

Solidus 3.2及以上版本才正式支持Rails 7，先检查Gemfile中的Solidus版本：
打开项目根目录下的Gemfile，查看solidus条目版本。若版本低于3.2，执行升级：

bundle update solidus

升级完成后，重新运行安装生成器：

bin/rails g solidus:install

2. 确认Solidus路由是否正确加载 #

执行路由检查命令，验证后台登录路由是否存在：

bin/rails routes | grep admin/login

若无输出，说明Solidus后台路由未正确挂载。手动在config/routes.rb中添加路由配置：

Rails.application.routes.draw do
  mount Solidus::Core::Engine, at: '/'
end

保存后重启服务器。

3. 清理缓存并重新预编译资源 #

缓存异常可能导致常量加载失败，执行以下命令清理缓存：

bin/rails tmp:clear
bin/rails assets:precompile

完成后重启Rails服务器。

4. 检查是否缺失solidus_backend依赖 #

Solidus后台功能依赖solidus_backend gem，确认Gemfile中包含该依赖：

gem 'solidus_backend'

若缺失，添加后执行：

bundle install
bin/rails g solidus:install

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