Rails 6升级至7后，禁用Turbolinks时Devise Flash消息失效

问题背景 #

• 环境：Rails 7，Devise 4.9.4，CanCanCan 3.6.1，已全局禁用Turbolinks
• 现象：新用户注册失败时，Flash错误提示不再显示；调试发现Rails 7中flash对象为空，Devise的set_flash_message方法未执行（Rails 6中该流程正常）
• 已尝试无效方案：注册表单添加data: { turbo: false }、定义TurboFailureApp配置Devise、手动设置响应状态码

排查与解决步骤 #

1. 修正Devise导航格式配置 #

Devise的navigational_formats决定了哪些请求格式会触发Flash消息逻辑。禁用Turbolinks后，需确保配置包含:html：

• 先在rails控制台验证当前配置：

  Devise.navigational_formats
  

• 如果结果不含:html，在config/initializers/devise.rb中修改：

  config.navigational_formats = ['*/*', :html]
  

• 重启服务器后测试。

2. 重写Devise注册控制器的响应逻辑 #

Rails 7的默认响应逻辑可能跳过了Devise的Flash设置流程，可自定义注册控制器强制触发Flash：

# app/controllers/users/registrations_controller.rb
class Users::RegistrationsController < Devise::RegistrationsController
  protected

  def respond_with(resource, options = {})
    if resource.errors.any?
      # 手动将错误信息写入Flash
      flash[:alert] = resource.errors.full_messages.join(', ')
      redirect_to new_user_registration_path
    else
      super
    end
  end
end

• 在config/routes.rb中指定自定义控制器：

  devise_for :users, controllers: { registrations: 'users/registrations' }
  

3. 验证responders gem兼容性 #

若Gemfile中包含responders，需确保版本适配Rails 7：

• 更新Gemfile：

  gem 'responders', '~> 3.1.0'
  

• 执行bundle update responders，重启服务器后测试。

4. 确认Flash渲染逻辑 #

检查布局文件（如app/views/layouts/application.html.erb）是否正确渲染Flash：

<% if flash[:alert] %>
  <div class="alert alert-danger"><%= flash[:alert] %></div>
<% end %>
<% if flash[:notice] %>
  <div class="alert alert-success"><%= flash[:notice] %></div>
<% end %>

避免因渲染代码缺失导致消息不显示。

5. 调试Flash触发流程 #

在自定义注册控制器中添加测试钩子，验证Flash是否能正常写入：

# app/controllers/users/registrations_controller.rb
before_action :test_flash, only: [:create]

def test_flash
  flash[:alert] = "测试Flash消息"
end

若测试消息能显示，说明问题出在Devise原生错误处理逻辑未触发，可继续排查Devise与Rails 7响应机制的兼容性。

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