Rails 7中Turbo Stream请求找不到匹配视图的问题

问题根源 #

你在respond_to的format.turbo_stream块里写了自定义逻辑，但没有显式触发模板渲染操作，导致Rails无法自动定位对应的视图文件；另外也可能是视图文件的位置或命名不符合Rails的约定规则。

具体解决办法 #

方法1：简化respond_to配置，让Rails自动匹配模板 #

如果不需要在Turbo Stream请求中添加额外逻辑，直接让Rails根据请求格式自动匹配视图：

def show
  respond_to :html, :turbo_stream
end

这样Rails会自动处理两种请求：

• TURBO_STREAM请求：自动查找app/views/admin/show.turbo-stream.html.slim
• HTML请求：自动查找app/views/admin/show.html.slim

方法2：在format块中显式调用render #

如果需要保留format.turbo_stream块内的日志逻辑，必须显式调用render告知Rails要渲染的模板：

def show
  respond_to do |format|
    format.turbo_stream do 
      Rails.logger.debug 'IN THE TURBO STREAM FORMAT'
      render # 自动匹配当前动作的Turbo Stream模板，也可指定路径如render 'show'
    end
    format.html # 处理HTML请求，自动对应html模板
  end
end

方法3：检查视图文件的位置与命名 #

确保视图文件放在正确目录：app/views/admin/show.turbo-stream.html.slim（AdminController对应的视图目录是admin），命名后缀顺序必须是.turbo-stream.html.slim，不能颠倒或写错后缀。

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