自定义路由报错uninitialized constant Api::V1::UserController求助

你遇到的「uninitialized constant Api::V1::UserController」错误，核心原因是路由中指定的控制器名称和实际控制器类名不匹配，完全是Rails命名约定的问题。

为什么会出错？ #

你的控制器类是Api::V1::UsersController（复数形式），对应的文件也是app/controllers/api/v1/users_controller.rb（复数蛇形命名），这完全符合Rails规范。但你的路由里写的是：

post "user/createuser", to: "user#create_user"

这里的"user#create_user"告诉Rails要去找Api::V1::UserController（单数），但你的实际类是UsersController（复数），所以Rails找不到对应的常量，就抛出了错误。

如何让自定义路由生效？ #

只需要把路由里的控制器名称从单数user改成复数users即可：

namespace 'api' do
  namespace 'v1' do
    post "user/createuser", to: "users#create_user"
  end
end

这样Rails就会正确定位到Api::V1::UsersController，并调用其中的create_user方法。

如果你想让路径更符合RESTful风格，也可以把路径部分改成复数：

namespace 'api' do
  namespace 'v1' do
    post "users/create_user", to: "users#create_user"
  end
end

为什么用resource :users能正常工作？ #

因为resource :users（或者resources :users）是Rails提供的RESTful路由助手，它会自动遵循Rails的命名约定：

• 自动对应复数的UsersController
• 默认把POST请求映射到控制器的create方法
  所以当你把控制器里的create_user改成create后，路由和控制器方法就完全匹配了，自然能正常运行。

额外注意点 #

• 确保控制器文件名和类名严格对应：文件名是users_controller.rb（复数蛇形），类名是UsersController（复数驼峰），你已经确认过目录结构，这部分没问题。
• 路由修改后如果没生效，可以重启服务器（不过这次的核心问题是名称不匹配，重启只是辅助验证）。

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