Rails集成ActionText更新内容时ActiveStorage报to_model未定义怎么解决？

问题根因 #

你遇到的是Rails 6.1.3版本的已知缺陷：该版本的ActiveStorage::VariantWithRecord类没有内置实现to_model方法，只有当更新操作需要回显已上传的富文本图片、生成图片变体渲染时才会触发该错误，新增操作时不需要渲染历史上传的图片变体因此不会报错。

解决方案 #

按照优先级从高到低执行以下排查操作：

1. 修复Rails版本兼容问题
   官方已经在6.1.4及以上的稳定小版本修复了该缺陷，你可以直接修改Gemfile中的Rails版本声明，执行bundle update rails升级即可。
   如果当前项目暂时不能升级Rails版本，可以添加临时补丁修复：
   在config/initializers/目录下新建active_storage_variant_patch.rb文件，写入以下代码：

ActiveStorage::VariantWithRecord.class_eval do
  delegate :to_model, to: :record
end

添加后重启Rails服务即可生效。

2. 确认ActiveStorage基础配置完整

• 确保你已经执行过ActiveStorage的安装命令：rails active_storage:install，并且执行了rails db:migrate生成ActiveStorage需要的三张核心表
• 检查config/application.rb中是否开启了对应组件加载，默认Rails 6+项目会默认加载，如果你之前手动关闭过默认组件需要补全以下配置：

require "active_storage/engine"
require "action_text/engine"

3. 确认update动作的强参数配置正确
   因为错误仅在update时触发，需要检查你的控制器强参数是否已经放开body字段权限：

def page_params
  params.require(:page).permit(:title, :body, # 其他业务字段)
end

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