在命名空间控制器中使用Rails路由路径助手遇路由匹配错误

问题描述 #

我有一个包含多个顶层模型的Rails应用，此前运行正常。布局视图中的头部局部视图包含导航栏主导航链接。为便于后续扩展，我将新增功能的模型和控制器封装到命名空间中以保持应用整洁。但访问第一个命名空间下的索引视图时加载失败，报错：

No route matches {:action=>"index", :controller=>"electrical/roles", :locale=>:en}

实际上roles路由并不在electrical命名空间下，错误源于头部局部视图的解析过程。该视图中link_to的代码与其他正常工作的视图写法一致，疑问如下：

• 是否因为在命名空间内的视图中调用路径助手，导致其自动添加了命名空间？
• 如果是，如何跳出命名空间？
• 能否让路径助手不自动修改路径，仅在需要时显式指定命名空间？

头部局部视图代码（/app/views/layouts/_header.html.erb） #

<% if current_user.has_role? :admin %>
          <li class="nav-item">
            <%= link_to t('role', scope: 'activerecord.models').pluralize,
              roles_path,
              class: ['nav-link', { active: current_page?(controller: 'roles') }],
              aria: { label: t('role', scope: 'activerecord.models').pluralize } %>
          </li>
        <% end %>

路由配置代码（/config/routes.rb） #

Rails.application.routes.draw do
  scope "(:locale)", locale: /#{I18n.available_locales.join("|")}/ do
    get 'site/home'
...
    devise_for :users
    resources :users, :only => [:show, :index]
    resources :projects
    resources :tags
    resources :users, :only => [] do
      resources :roles, :only => [:destroy]
    end
    resources :roles, :only => [:index, :new, :create]
    namespace :electrical do
      resources :cable_types
...
      resources :cables
    end
  end

  # Defines the root path route ("/")
  root to: 'site#home'
end

问题原因 #

没错，就是因为在命名空间（如electrical）下的视图中调用路径助手时，Rails会自动继承当前视图所在的命名空间上下文，导致roles_path被错误解析为electrical/roles的路径，而你的roles是顶层路由，因此匹配失败。

解决方法 #

1. 使用main_app.前缀指定顶层路由 #

这是最直接可靠的方式，通过main_app.前缀明确告诉路径助手要调用顶层路由，而非当前命名空间下的路由。修改头部视图代码如下：

<% if current_user.has_role? :admin %>
          <li class="nav-item">
            <%= link_to t('role', scope: 'activerecord.models').pluralize,
              main_app.roles_path,
              class: ['nav-link', { active: current_page?(main_app.roles_path) }],
              aria: { label: t('role', scope: 'activerecord.models').pluralize } %>
          </li>
        <% end %>

同时current_page?的判断也要改用main_app.roles_path，避免同样的上下文问题。

2. 显式指定顶层控制器（针对current_page?） #

如果只是current_page?的判断出错，可以在控制器名前加斜杠/，明确表示这是顶层控制器：

current_page?(controller: '/roles')

这种方式适合仅修正页面激活状态判断的场景，但路径助手仍建议用main_app.前缀更清晰。

3. 不推荐：修改视图上下文 #

虽然可以通过在局部视图中手动设置controller_path来切换上下文，但这种方式容易引发其他潜在问题，维护性差，不建议使用。

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