将整数列转为字符串数组的Rails 3迁移在Rails 5中执行失败

我来帮你搞定这个迁移在Rails 5里的问题，先直接给你修复后的代码，再拆解背后的原因：

class ChangeWdayFromIntegerToStringInResourceWeekDayStart < ActiveRecord::Migration[5.0]
  def up
    # 先把原有整数数据转成单元素数组的字符串格式（比如1变成"[1]"）
    execute <<-SQL
      UPDATE resource_week_day_starts SET wday = '[' || wday || ']';
    SQL

    # 明确声明为字符串数组类型，array: true是Rails 5里的关键配置
    change_column :resource_week_day_starts, :wday, :string, array: true, default: []
    add_column :resource_week_day_starts, :number_days, :integer, default: 7
  end

  def down
    # 先从数组中提取单个元素（还原回原整数的字符串形式）
    execute <<-SQL
      UPDATE resource_week_day_starts SET wday = (wday::text[])[1];
    SQL

    # 转换回整数类型
    change_column :resource_week_day_starts, :wday, :integer
    remove_column :resource_week_day_starts, :number_days
  end
end

原迁移在Rails 5里失败的核心原因 #

我给你拆解几个关键问题点：

• 数组类型声明缺失：Rails 3可能隐式处理了数组序列化，但Rails 5要求必须显式加array: true，才能让数据库识别这是数组类型（比如PostgreSQL的text[]）。原代码只写了:string, default: []，数据库会把它当成普通字符串存储，后续转换时数据格式完全混乱。
• Down方法的转换逻辑错误：原代码直接用CAST(wday AS integer)，但此时wday是数组格式的字符串（比如"[1]"），直接转整数会触发数据库语法报错。我们需要先把数组里的单个元素提取出来，再做类型转换。
• Rails 5的语法校验更严格：Rails 5对change_column的参数校验比3.x更严谨，默认不会把default: []识别为数组默认值，必须搭配array: true才能生效。

额外注意事项 #

• 如果你用的是MySQL，因为它没有原生数组类型，Rails会用序列化处理，这时候需要把:string, array: true换成:text，并在对应的模型里添加serialize :wday, Array。不过更推荐用PostgreSQL来支持原生数组类型，避免序列化带来的潜在问题。
• 执行迁移前一定要先备份数据，或者在测试环境完整验证一遍，避免数据丢失。

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