Rails中Devise结合Devise Token Auth登录表单不显示问题求助

看起来你遇到的核心问题是API模式下的Rails默认缺少视图渲染所需的中间件和模块，虽然你创建了继承ActionController::Base的AppController，但整个应用的配置和Devise的控制器继承关系还没适配这种混合模式。下面是一步步的解决方法：

1. 调整Devise控制器的继承关系 #

默认情况下，Devise生成的控制器会继承你的ApplicationController（也就是ActionController::API），而API控制器没有视图渲染能力。你需要为后台的Devise操作创建自定义控制器，让它们继承AppController：

• 首先生成Devise的自定义控制器（以管理员后台为例）：

  rails generate devise:controllers admin
  

• 打开生成的会话控制器app/controllers/admin/sessions_controller.rb，修改继承关系为AppController：

  class Admin::SessionsController < AppController
    # 保留Devise的默认前置动作和方法
    prepend_before_action :require_no_authentication, only: [:new, :create]
    prepend_before_action :allow_params_authentication!, only: :create
    prepend_before_action :verify_signed_out_user, only: :destroy
  
    def new
      self.resource = resource_class.new(sign_in_params)
      clean_up_passwords(resource)
      yield resource if block_given?
      respond_with(resource, serialize_options(resource))
    end
  
    # 其他默认方法（create、destroy等）保持不变
  end
  

• 在config/routes.rb中更新Devise路由，指向这个自定义控制器：

  devise_for :admins, controllers: { sessions: 'admin/sessions' }
  

2. 启用视图所需的中间件 #

API模式下Rails会自动移除Cookie、Flash、Session等与视图相关的中间件，而Devise的表单依赖这些功能。你需要在config/application.rb中手动添加回来：

module YourAppName
  class Application < Rails::Application
    # 如果你希望保留API模式的其他特性，只添加必要的中间件：
    config.middleware.use ActionDispatch::Cookies
    config.middleware.use ActionDispatch::Session::CookieStore
    config.middleware.use ActionDispatch::Flash

    # 如果你不需要严格的API模式，也可以直接关闭api_only（但可能影响原有API接口，需测试）：
    # config.api_only = false
  end
end

3. 确保Devise视图文件存在 #

自定义Devise控制器后，需要对应的视图文件才能渲染登录表单。运行以下命令生成后台的Devise视图：

rails generate devise:views admin

这会在app/views/admin目录下生成所有Devise相关视图，包括登录表单app/views/admin/sessions/new.html.erb。

4. 验证AppController的配置 #

确保你的AppController没有禁用视图渲染的设置：

• 检查是否有skip_before_action :verify_authenticity_token（Devise默认会处理CSRF，但如果是API模式遗留的配置，可能需要调整）
• 确认没有设置render nothing: true或其他强制跳过视图的代码

5. 排查日志和路由 #

• 运行rails routes命令，确认后台登录路由（比如/admins/sign_in）指向Admin::SessionsController#new
• 查看log/development.log，访问登录页面时的请求日志会告诉你具体错误（比如模板缺失、控制器无渲染能力等）

按照这些步骤调整后，应该就能正常显示Devise的登录表单了。

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