Rails 7.1.3脚手架表单默认处理为HTML而非TURBO_STREAM的疑问

以下是几个常见原因及对应的排查方向：

• Turbo 未正确加载
  Rails 7 默认通过 importmaps 引入 Turbo，检查 app/javascript/application.js 是否包含以下代码：

  import "@hotwired/turbo-rails"
  

  如果使用 jsbundling-rails 或 webpacker，同样要确认 Turbo 已被正确导入并初始化。前端未加载 Turbo 时，表单不会发送 Turbo 所需的请求头，后端就会默认处理为 HTML 格式。

• 表单缺少 data-turbo="true" 属性
  Rails 脚手架生成的表单应该自动添加该属性，可查看页面源码确认表单标签是否包含：

  <form data-turbo="true" ...>
  

  若缺失，可能是脚手架模板被意外修改，或 Devise 的配置间接影响了表单生成（不过仅修改邮件配置一般不会触发这个问题）。

• Turbo 被全局禁用
  检查是否在初始化文件或前端代码中禁用了 Turbo：

  • 后端：查看 config/initializers/turbo.rb 是否存在 Rails.application.config.turbo.enabled = false 配置
  • 前端：查看 application.js 是否有 Turbo.session.drive = false 这样的代码

• Devise 版本兼容性问题
  确保使用的 Devise 版本适配 Rails 7.1，建议使用 Devise 4.8.0 及以上版本。旧版 Devise 可能会对 Turbo 的表单处理造成干扰，即便仅修改了邮件配置，版本不兼容也可能间接引发问题。

• 请求头异常
  打开浏览器开发者工具，查看表单提交时的请求头，确认是否包含 Accept: text/vnd.turbo-stream.html, text/html, application/xhtml+xml。如果没有这个头，说明前端 Turbo 未正常工作，后端会按默认的 HTML 格式处理请求。

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