Rails POST请求完成视图渲染但浏览器停留原表单页问题排查

直接看运行日志里的*Processing by SoothController#search as TURBO_STREAM*就能定位：Rails 7+ 版本默认集成Turbo Drive，所有非GET类型的表单请求会被Turbo接管，默认期望返回Turbo Stream格式的响应用来做局部页面更新。这种场景下控制器直接返回全量HTML的200响应，Turbo不会触发整页跳转，浏览器自然就停在原表单页。GET请求不受Turbo这条规则限制，所以能正常运行，和路由配置、业务处理逻辑本身无关。

• 方案1：最小改动适配，不需要调整现有代码结构，二选一操作即可：
  1. 在表单标签上添加data: { turbo: false }属性，让表单走原生浏览器提交逻辑，不被Turbo接管：

  <%# 表单代码修改示例 %>
  <%= form_with url: "/sooth/search", method: :post, data: { turbo: false } do |f| %>
    <%# 原有表单项内容保持不变 %>
  <% end %>
  

  2. 在控制器渲染时明确指定响应格式为HTML，强制Turbo按全页HTML响应处理：

  def search
    form_params = params[:search]
    puts 'searching' + form_params[:name].to_s
    render "sooth/search", formats: [:html]
  end
  

• 方案2：遵循Rails+Turbo官方开发规范调整逻辑
  Turbo要求所有POST请求处理完成后，应通过重定向的方式跳转页面（符合PRG即Post/Redirect/Get设计模式），不要在POST动作中直接渲染页面。修改控制器逻辑如下：

  def search
    form_params = params[:search]
    puts 'searching' + form_params[:name].to_s
    # 业务逻辑处理完成后重定向到结果页
    redirect_to "/sooth/search?#{form_params.to_query}"
  end
  

  使用该方案需要在路由中补充对应GET路由承接重定向请求，同时修复现有路由的语法错误（当前配置重复嵌套了Rails.application.routes.draw do块，且缺少一个end闭合），修正后的路由配置如下：

  Rails.application.routes.draw do
    get "/nlp_data", to: "nlp_data#index"
    get "/sooth", to: "sooth#index"
    post "/sooth/search", to: "sooth#search"
    get "/sooth/search", to: "sooth#search" # 新增承接重定向的GET路由
  end
  

  该写法是框架推荐的标准实现，后续使用Turbo的页面加速、局部更新能力时不会出现兼容问题。

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