在现有Rails应用中挂载Alchemy CMS遇路由错误求助

1. 调整路由挂载顺序与写法 #

Rails路由按从上到下顺序匹配，确保Alchemy挂载代码在Active Admin之前，避免路由被提前拦截。修改config/routes.rb：

Rails.application.routes.draw do
  # 挂载Alchemy CMS到/cms路径，指定命名空间避免冲突
  mount Alchemy::Engine => '/cms', as: :alchemy

  # 挂载Active Admin
  devise_for :admin_users, ActiveAdmin::Devise.config
  ActiveAdmin.routes(self)

  # 其他业务路由...
end

2. 确认Alchemy后台路由配置 #

检查Alchemy初始化文件和配置文件，确保后台路由前缀未设为绝对路径：

• 编辑config/initializers/alchemy.rb：

  Alchemy.configure do |config|
    # 后台路由前缀设为相对路径，挂载后对应/cms/admin
    config.admin_path = 'admin'
    # 避免设置为'/admin'，会直接指向根路径的admin路由
    config.devise_scope = :alchemy_user
  end
  

• 同步config/alchemy/config.yml的配置：

  default: &default
    admin_path: admin
  

3. 修复Devise路由冲突 #

若Active Admin与Alchemy的Devise配置冲突，可在路由中单独指定Alchemy的Devise规则：

Rails.application.routes.draw do
  mount Alchemy::Engine => '/cms', as: :alchemy do
    devise_for :alchemy_users, class_name: 'Alchemy::User', module: :devise
  end

  devise_for :admin_users, ActiveAdmin::Devise.config
  ActiveAdmin.routes(self)
end

4. 清除路由缓存并验证 #

执行以下命令清除路由缓存，重新生成路由规则：

rake routes:clear
rails routes

确认输出中存在类似以下的路由条目：

alchemy_admin        GET    /cms/admin(.:format)          alchemy/admin#index

5. 排查自定义路由干扰 #

检查项目中是否存在全局路由约束、正则匹配路由或其他引擎的路由挂载在Alchemy之前，这些可能会拦截/cms/admin的请求。

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