Rails 6.1运行turbo:install报缺bin/bundle及TURBO_STREAM异常

补充bin/bundle文件后依然存在请求格式异常的问题，可以确定两个问题不存在直接因果关联：bin/bundle缺失仅会影响Rails rake任务执行时的Bundler命令调用流程，和Turbo的前端请求拦截、请求头写入逻辑没有模块耦合。

• 该报错本质是turbo-rails 0.5.9版本的安装脚本硬编码了对项目根目录下bin/bundle可执行stub的调用，全新Rails 6.1.3项目创建时，如果指定了--skip-bundle、--skip-binstubs类参数，就不会自动生成这个文件。
• 不建议直接从其他项目复制bin/bundle文件——这类binstub文件会硬编码当前项目的Ruby可执行文件路径，跨项目复制很容易出现路径不匹配的二次报错。直接在项目根目录运行bundle binstubs bundler，即可生成适配当前项目环境的合法bin/bundle文件。
• 生成完成后重新运行rails turbo:install，逐次排查脚本执行过程中是否还有其他binstub类的缺失报错，直到安装脚本走完正常流程。

结合你使用webpacker@6.0.0-beta.5的环境特征，可按优先级从以下方向排查：

• 第一优先级校验前端Turbo的初始化状态
  • 打开浏览器开发者工具的Console面板，执行window.Turbo：如果返回undefined，说明Turbo脚本根本没有挂载到全局上下文，所有链接都会走原生HTML请求流程，完全不会被Turbo拦截。
  • 检查app/javascript/packs/application.js的导入逻辑：webpacker 6 beta环境下极易出现导入冲突，比如重复导入Turbo包、手动调用Turbo.start()和包自带的自动初始化逻辑冲突，甚至因为模块加载顺序错乱导致Turbo初始化直接失败。
  • 检查turbo-rails gem和前端@hotwired/turbo npm包的版本匹配性：turbo-rails 0.5.9对应的前端JS包版本是固定区间的，如果手动安装的npm包版本和gem要求的差异过大，会出现前端初始化了Turbo，但拦截逻辑失效、不写入对应请求头的问题。
  • 检查页面上的目标链接、Turbo Frame元素，有没有被误加data-turbo="false"属性——该属性会强制跳过Turbo的拦截逻辑，直接发送原生HTML请求。
• 第二方向校验打包链路的完整性
  • webpacker 6 beta的模块打包逻辑和稳定版差异极大，很容易出现Turbo相关代码被tree-shaking误删、被拆分为独立异步chunk，导致首屏加载时Turbo未及时绑定全局事件的问题。可以在打包产出的js文件中搜索TURBO_STREAM关键字，如果搜不到匹配内容，说明Turbo的核心逻辑根本没有被打进最终的页面js包中。
  • 检查是否存在多份Turbo包被重复打包的问题：多实例的Turbo不会绑定全局点击事件，自然无法拦截链接跳转请求。
• 第三方向验证请求触发逻辑
  • 提前打开开发者工具的Network面板，勾选保留日志后再点击目标链接，查看请求头的Accept字段：如果字段值仅包含text/html，完全没有text/vnd.turbo-stream.html的相关声明，即可确认该请求没有经过Turbo拦截，完全是浏览器原生发起的HTML请求。

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