You need to enable JavaScript to run this app. Rails 6.1 RC1 升级后 ActionText 表单 AJAX 自动保存触发缺失模板错误
优惠活动
大模型
产品
解决方案
定价
更多

Rails 6.1 RC1 升级后 ActionText 表单 AJAX 自动保存触发缺失模板错误

问题根因

该报错的触发逻辑与Rails #39266号改动直接相关,属于Rails 6.1 RC1版本引入的回归问题:

  • Rails 6.1 alpha版本中,Action Text富文本对象在JSON序列化时,会直接返回数据库存储的原始HTML字符串,不会触发视图模板渲染流程
  • RC1版本调整了Action Text的序列化逻辑:为对齐前端Trix编辑器的回显逻辑,代码在富文本对象的序列化方法中,强制触发action_text/content/_layout局部模板的渲染流程,且未做两层关键判断:
    1. 未判断当前请求的响应格式是否为HTML
    2. 未适配当前视图查找器的format上下文
      执行render json: @model返回模型对象时,序列化流程会自动加载模型关联的Action Text富文本属性,触发上述模板渲染逻辑。此时视图查找器的可用格式被JSON请求锁定,仅允许查找对应JSON格式的模板,自然无法匹配专为HTML响应准备的富文本布局模板,最终抛出MissingTemplate错误。
可落地的解决方案

按优先级从优到劣排列:

  • 优先方案:序列化时手动指定富文本字段的取值,绕开自动渲染逻辑
    自动保存接口本身不需要返回渲染后带布局的富文本内容,仅需返回保存状态、时间戳等基础信息,可替换原本直接渲染模型对象的写法,明确指定序列化返回字段,避免触发Action Text的自动渲染流程:

    def update
      respond_to do |format|
        if @model.update(model_params)
          # 手动指定序列化字段,不触发Action Text的自动渲染
          format.json { render json: @model.as_json(only: [:id, :updated_at, :title]) }
        else
          format.json { render json: @model.errors, status: :unprocessable_entity }
        end
      end
    end
    

    如果接口确实需要返回富文本内容,直接关联取存储的原始blob值即可,无需走模板渲染流程:

    format.json do
      render json: {
        id: @model.id,
        updated_at: @model.updated_at,
        content_html: @model.content.body.to_s
      }
    end
    
  • 临时应急方案:补全对应JSON格式的占位模板
    如果短期内无法调整接口序列化逻辑,可在项目路径下创建空的占位模板,绕开模板缺失的报错:

    • 新建文件app/views/action_text/content/_layout.json.erb,文件内容留空即可
      该方案仅适合紧急场景使用,本质没有解决自动渲染的逻辑问题,只是给模板查找流程提供了匹配JSON格式的空文件。
  • 版本适配方案:升级至Rails 6.1正式版
    该回归问题已在Rails 6.1正式版中修复,调整了Action Text序列化时的模板查找逻辑,会自动判断当前响应格式,非HTML请求直接返回原始存储的内容字符串,不会强制查找HTML格式的布局模板。


内容的提问来源于stack exchange,提问作者Olly

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 14:06:03