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局部模板的渲染流程,且未做两层关键判断:- 未判断当前请求的响应格式是否为HTML
- 未适配当前视图查找器的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
相关产品推荐
相关产品推荐

