Rails：子域约束下同名控制器的正确配置方法

这个问题我之前也踩过坑，核心原因是Rails路由是从上到下按顺序匹配的，你把无约束的resources :documents放在了带子域约束的路由前面，导致访问test.localhost:3000/documents时，先匹配到了最上方的通用路由，而不是你期望的Test::DocumentsController。

修正后的路由配置 #

把带子域约束的路由块移到无约束路由的前面，让Rails优先检查更具体的子域规则：

# 先处理带子域约束的路由
constraints subdomain: 'test' do
  scope module: 'test' do
    resources :documents
    root to: 'documents#index'
  end
end

# 再处理通用路由
resources :documents
root to: 'documents#index'

额外需要确认的点 #

除了路由顺序，还要确保你的控制器文件结构和类定义是正确的：

• Test::DocumentsController的文件必须放在 app/controllers/test/documents_controller.rb
• 类定义要正确嵌套：

  class Test::DocumentsController < ApplicationController
    # 你的动作代码
    def index
      # ...
    end
  end
  

这样调整后，http://localhost:3000/documents就会匹配到根命名空间的DocumentsController，而http://test.localhost:3000/documents则会正确路由到Test::DocumentsController了。

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