蓝绿部署新增数据库列时如何处理ActiveModel::UnknownAttributeError？

一、代码层面过滤属性 #

旧容器的模型schema缓存不包含新列，直接使用attributes哈希创建会报错，核心思路是只保留当前模型能识别的属性：

• 在创建对象时，用模型的attribute_names方法过滤属性哈希：

  attributes = MyTable.find(X).attributes
  # 只保留当前模型支持的属性
  safe_attributes = attributes.slice(*MyTable.attribute_names)
  MyTable.create!(safe_attributes)
  

• 可以封装成通用方法复用：

  def safe_model_attributes(model_class, attributes)
    attributes.slice(*model_class.attribute_names)
  end
  
  # 使用示例
  safe_attrs = safe_model_attributes(MyTable, MyTable.find(X).attributes)
  MyTable.create!(safe_attrs)
  

• 兼容非空列场景：新增非空列时，迁移需设置默认值（如add_column :my_table, :xxx, :string, null: false, default: ""），旧容器过滤后创建对象，数据库会自动填充默认值，不会触发非空约束报错。

二、分阶段调整发布与迁移流程 #

将数据库迁移和代码发布拆分为多阶段，避免新旧版本直接冲突：

1. 第一阶段：部署兼容代码+执行基础迁移
   • 先编写兼容新旧版本的代码：新代码能处理无新列的情况，旧代码能容忍数据库存在新列（通过上述属性过滤实现）。
   • 执行迁移：新增列时先设置允许空或带默认值（如果是非空列，优先用带默认值的方式创建，如add_column :my_table, :xxx, :integer, null: false, default: 0），确保旧容器创建对象时，数据库能自动填充合法值。
2. 第二阶段：部署最终业务代码
   • 等待所有旧容器被替换为第一阶段的兼容代码容器后，再部署包含新列业务逻辑的代码。
3. 可选第三阶段：调整列约束
   • 如果需要移除默认值或调整非空规则，等所有容器都是最终版本后，再执行对应的迁移操作。

三、强制刷新旧容器的Schema缓存 #

Rails支持通过信号触发Schema缓存刷新，在迁移完成后通知旧容器更新缓存：

• 执行完数据库迁移后，给所有旧容器发送SIGUSR1信号（Rails框架默认监听该信号，收到后会重新加载Schema缓存）。
• 操作示例（假设用Docker管理容器）：

  # 筛选旧版本容器并发送信号
  docker ps --filter "name=old-container-pattern" -q | xargs docker kill -s SIGUSR1
  

• 兼容非空列场景：迁移完成后刷新缓存，旧容器的模型会识别新列，使用attributes创建对象时不会触发未知属性错误，同时数据库的非空约束已由迁移确保合法。

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