Rails迁移：如何在迁移文件中定义Active Record序列化规则？

当然可以！你完全不需要依赖原模型的序列化配置，直接在迁移文件里手动实现Hash的序列化/反序列化逻辑就好——这样哪怕从头执行整套迁移，也不会因为模型配置的变化而出错。下面是具体的思路和代码示例：

核心思路 #

原表的text字段里存的是Rails序列化后的Hash（默认用YAML格式，也可能是JSON，取决于你当初的模型配置），我们可以在迁移里直接解析这个字符串转成Hash，再把处理后的内容写入新表，全程不依赖模型的serialize声明。

具体实现步骤 #

1. 确认序列化格式 #

先搞清楚原模型用的是哪种序列化方式：

• 如果模型里是serialize :your_field，默认是YAML格式，用YAML.safe_load解析，YAML.dump生成
• 如果是serialize :your_field, JSON，就用JSON.parse和JSON.generate

2. 编写迁移文件 #

下面是一个完整的迁移示例，假设你要把old_records表的serialized_data字段（text类型，存序列化Hash）迁移到new_records表的data_hash字段：

class MoveSerializedHashToNewTable < ActiveRecord::Migration[7.0]
  def up
    # 第一步：创建目标新表
    create_table :new_records do |t|
      t.text :data_hash
      t.references :old_record, null: false, foreign_key: true # 关联原表记录
      t.timestamps
    end

    # 第二步：批量迁移数据，手动处理序列化
    OldRecord.find_each(batch_size: 1000) do |old_record|
      # 反序列化原字段的字符串为Hash（这里用YAML示例，根据实际格式调整）
      original_hash = YAML.safe_load(
        old_record.serialized_data,
        permitted_classes: [Hash, String, Integer, Float, TrueClass, FalseClass]
      )

      # 将Hash序列化后写入新表（如果新表字段也需要存序列化字符串）
      NewRecord.create!(
        old_record: old_record,
        data_hash: YAML.dump(original_hash)
      )
    end

    # 第三步：可选，移除原表的旧字段（确认数据迁移正确后再执行）
    remove_column :old_records, :serialized_data
  end

  def down
    # 回滚逻辑：恢复原字段并迁移数据回去
    add_column :old_records, :serialized_data, :text

    NewRecord.find_each do |new_record|
      restored_hash = YAML.safe_load(
        new_record.data_hash,
        permitted_classes: [Hash, String, Integer, Float, TrueClass, FalseClass]
      )
      new_record.old_record.update!(serialized_data: YAML.dump(restored_hash))
    end

    drop_table :new_records
  end
end

关键注意事项 #

• 安全优先：一定要用YAML.safe_load而不是YAML.load，避免反序列化漏洞。根据你的数据结构，调整permitted_classes里允许的类型，只包含实际用到的类。
• 性能优化：数据量大时，用find_each分批处理，避免一次性加载所有记录导致内存溢出，还可以通过batch_size调整批次大小。
• 验证数据：迁移完成后，一定要抽查几条记录，对比原Hash和新表存储的Hash内容是否完全一致，避免格式转换出错。
• 适配JSON序列化：如果原模型用的是JSON序列化，把代码里的YAML.safe_load换成JSON.parse，YAML.dump换成JSON.generate即可。

这样实现的好处是，迁移逻辑完全独立于模型代码——哪怕原模型已经删除了serialize声明，或者从头执行迁移时模型还没配置序列化，迁移都能正确识别并处理数据，不会出现把Hash当成字符串的问题。

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