Ruby on Rails中Devise注册/登录页出现NoMethodError错误求助

在Ruby on Rails应用中使用Devise做身份验证时，访问注册页（http://localhost:3000/users/sign_up）或登录页（http://localhost:3000/users/sign_in）触发如下错误：

Showing /mnt/c/PH-Page/pauloskaterock/app/views/layouts/application.html.erb where line #40 raised:

undefined method `flash' for #<ActionDispatch::Request GET "http://localhost:3000/users/sign_up" for ::1>
Extracted source (around line #40):

    <body>
    <% if notice %>
    <p class="notice"><%= notice %></p>
    <% end %>
    <% if alert %>

环境背景 #

• Ruby on Rails应用，集成Devise身份验证
• 执行rails s启动服务器后，访问对应页面触发错误

已尝试操作 #

1. 确认application.html.erb布局文件内容：

<!DOCTYPE html>
<html>
<head>
<title>Minha Pagina Pessoal</title>
<%= csrf_meta_tags %>
<%= csp_meta_tag %>

<%= stylesheet_link_tag 'application', media: 'all', 'data-turbolinks-track': 'reload' %>
<%= javascript_include_tag 'application', 'data-turbolinks-track': 'reload' %>
</head>

<body>
<% if notice %>
<p class="notice"><%= notice %></p>
<% end %>
<% if alert %>
<p class="alert"><%= alert %></p>
<% end %>

<%= yield %>
</body>
</html>

2. 确认ApplicationController配置：

class ApplicationController < ActionController::Base
  protect_from_forgery with: :exception

  before_action :configure_permitted_parameters, if: :devise_controller?

  protected

  def configure_permitted_parameters
    devise_parameter_sanitizer.permit(:sign_up, keys: [:username, :email, :password, :password_confirmation])
    devise_parameter_sanitizer.permit(:sign_in, keys: [:email, :password])
    devise_parameter_sanitizer.permit(:account_update, keys: [:username, :email, :password, :password_confirmation, :current_password])
  end
end

3. 已执行rails generate devise:views生成Devise视图文件

问题原因与修复方案 #

原因

notice/alert方法默认依赖控制器上下文的flash哈希，但错误显示flash被绑定到了ActionDispatch::Request实例而非控制器对象，通常由以下原因导致：

• Devise与Rails版本不兼容
• 控制器未正确引入Devise的帮助模块
• 自定义中间件破坏了请求上下文的flash绑定

修复步骤

1. 校验版本兼容性
   查看Gemfile中Devise版本，确保与当前Rails版本匹配（如Rails 7.x需Devise 4.8+，Rails 6.x需Devise 4.7+）。若版本不兼容，执行更新：

   bundle update devise
   

2. 显式引入Devise帮助模块
   修改ApplicationController，手动加入Devise的控制器帮助模块：

   class ApplicationController < ActionController::Base
     protect_from_forgery with: :exception
     include Devise::Controllers::Helpers
   
     before_action :configure_permitted_parameters, if: :devise_controller?
   
     protected
   
     def configure_permitted_parameters
       devise_parameter_sanitizer.permit(:sign_up, keys: [:username, :email, :password, :password_confirmation])
       devise_parameter_sanitizer.permit(:sign_in, keys: [:email, :password])
       devise_parameter_sanitizer.permit(:account_update, keys: [:username, :email, :password, :password_confirmation, :current_password])
     end
   end
   

3. 排查自定义中间件
   若项目中有自定义中间件，暂时移除后重启服务器测试，确认是否是中间件干扰了请求上下文。

4. 清除缓存并重启服务器
   执行缓存清理命令后重启服务：

   rails tmp:clear
   rails s
   

5. 临时修复：直接调用flash哈希
   修改application.html.erb中的通知代码，直接访问flash哈希代替notice/alert方法：

   <% if flash[:notice] %>
   <p class="notice"><%= flash[:notice] %></p>
   <% end %>
   <% if flash[:alert] %>
   <p class="alert"><%= flash[:alert] %></p>
   <% end %>
   

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