Rails 6服务端渲染页面Flash消息丢失问题排查

我有一个从Rails 5迁移而来的Rails 6应用，用于管理Item及其Overview页面。更新Item后会重定向至Overview页面，Items Controller中的update方法代码如下：

class ItemsController < ApplicationController
  def update
    respond_to do |format|
      if @item.update(item_params)
        format.html { redirect_to overview_path, notice: "Item updated." }
      else
        format.html { redirect_to overview_path, alert: "An error happend." }
      end
    end
  end
end

因需求需提供纯HTML形式的简单API供微服务使用，功能正常但服务端生成的HTML中缺少Flash消息。已在config/application.rb中配置config.middleware.use ActionDispatch::Flash，且Overview Controller中手动设置flash[:notice]可正常显示，但重定向后flash.inspect为空，请问问题出在哪？

问题根源是Rails 6默认启用的Turbo Drive（原Turbo Rails）——它会拦截页面跳转请求，改用AJAX方式处理，而传统Flash消息依赖session存储、仅在重定向后的下一次完整请求生效，Turbo的异步处理逻辑会导致Flash消息无法被正确传递到目标页面。

给你两种可行的解决办法：

• 方法一：强制走传统页面跳转
  在触发更新操作的表单中添加data-turbo="false"属性，禁用Turbo对该请求的拦截，让浏览器执行完整的页面刷新，这样Flash消息就能正常传递：

  <%= form_with(model: @item, data: { turbo: false }) do |form| %>
    <!-- 表单内容 -->
  <% end %>
  

• 方法二：适配Turbo的Flash处理机制
  Turbo要求重定向请求使用303状态码（status: :see_other）才能正确识别并传递Flash消息，修改ItemsController的update方法即可：

  class ItemsController < ApplicationController
    def update
      respond_to do |format|
        if @item.update(item_params)
          format.html { redirect_to overview_path, notice: "Item updated.", status: :see_other }
        else
          format.html { redirect_to overview_path, alert: "An error happened.", status: :see_other }
        end
      end
    end
  end
  

  同时确保布局文件里正确渲染Flash消息，比如：

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

另外可以确认下config/application.rb中Turbo的配置是否正常，但上面两种方法已经能解决当前问题。

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