ActiveRecord操作遗留MySQL库因毫秒字段解析报hour out of range异常

• 报错触发点位于MySQL适配器的结果集解析阶段：适配器根据数据库schema的字段类型，对识别为DateTime的字段执行反序列化后，直接调用utc方法转换时区
• 存毫秒值的字段被误判为DateTime类型，13位长度的毫秒时间戳直接被传入时间构造方法，超出合法时间范围，抛出hour out of range异常
• 异常在模型实例化之前的结果集转哈希环节抛出，因此业务代码中的rescue ArgumentError根本无法捕获；之前修改ActiveSupport解析逻辑的方案也不生效——因为异常根本不会走到ActiveSupport的时间解析分支

方案1：模型层显式重写字段类型映射（优先推荐） #

ActiveRecord 6.0 原生支持在模型层手动覆盖数据库自动推断的字段类型，完全不需要修改表结构或底层适配器代码。
操作步骤：

1. 定位触发报错的毫秒字段（根据给出的模型定义，对应user_created字段）
2. 在模型内通过attribute方法强制将该字段类型从默认的:datetime改为:integer，绕开原有的DateTime解析流程
3. 原有的属性别名、业务逻辑保持不变，需要时间格式输出时手动做毫秒到秒的转换

示例代码：

class User < ApplicationRecord
  self.table_name = :user
  self.primary_key = :user_id

  # 覆盖误判为datetime的毫秒字段为整数类型，必须放在所有alias定义之前
  attribute :user_created, :integer

  alias_attribute :first_name, 'user_firstname'
  alias_attribute :last_name, 'user_lastname'
  alias_attribute :email, 'user_email'
  alias_attribute :phone, 'user_contact_number'
  alias_attribute :job_title, 'user_job_title'
  alias_attribute :contact_status, 'user_contact_status'
  alias_attribute :created_at, 'user_created'

  # 自定义方法获取标准时间对象，替代原DateTime字段的输出
  def created_at_normalized
    Time.at(created_at / 1000).in_time_zone
  end
end

注意：如果之前尝试该方法没生效，90%是因为attribute方法的定义位置放在了alias_attribute之后，别名会触发原类型映射的重新加载，把手动指定的类型覆盖回去。

方案2：查询层SQL类型转换（适用于类型覆盖不生效的场景） #

如果因为ActiveRecord版本兼容性问题，模型层的类型覆盖无法生效，可以直接在SQL查询阶段把目标毫秒字段强制转成整数类型返回，让适配器从结果元数据层面就把它识别为integer，完全绕开DateTime解析分支。
操作步骤：

• 在模型内定义默认作用域，将原毫秒字段通过CAST函数转为无符号整数返回，避免和原字段名冲突

示例代码：

class User < ApplicationRecord
  self.table_name = :user
  self.primary_key = :user_id

  # 默认查询时把原user_created字段转成整数类型返回
  default_scope do
    from(
      Arel.sql("(SELECT user.*, CAST(user_created AS UNSIGNED) AS user_created_converted FROM user) AS user")
    )
  end

  # 别名指向转换后的字段
  alias_attribute :user_created, 'user_created_converted'
  alias_attribute :created_at, 'user_created'
  # 其他原有别名保持不变
end

该方案的核心逻辑是：SQL层返回的字段类型为无符号整数，mysql2 gem会自动将其标记为长整型，ActiveRecord在加载schema缓存时会直接识别为integer类型，不会触发后续的DateTime反序列化和utc转换逻辑。

方案3：精准补丁适配器行解析逻辑（兜底方案） #

如果前两个方案都因为项目特殊配置无法生效，可以通过最小粒度的补丁修改MySQL适配器的行解析流程，仅对目标报错字段跳过DateTime处理，其他字段保持原有逻辑不变。
操作步骤：

• 在初始化文件中新增适配器补丁，仅对指定字段做特殊处理，不全局影响其他字段的解析逻辑

示例代码：

# config/initializers/ar_mysql_legacy_patch.rb
ActiveRecord::ConnectionAdapters::Mysql2Adapter.module_eval do
  def exec_query_with_skip_legacy_field(sql, name = "SQL", binds = [], prepare: false)
    # 直接获取mysql2原生查询结果，不做自动类型转换
    raw_result = raw_connection.query(sql, as: :hash)
    processed_rows = raw_result.map do |row|
      # 暂存目标毫秒字段的原始值
      legacy_ms_value = row.delete("user_created")&.to_i
      # 其余字段走原有解析逻辑
      parsed_row = User.column_types.except("user_created").each_with_object({}) do |(col, type), hash|
        hash[col] = type.deserialize(row[col])
      end
      # 把暂存的毫秒值塞回解析后的行
      parsed_row["user_created"] = legacy_ms_value
      parsed_row
    end
    # 封装为标准AR返回结果，不影响上层调用逻辑
    ActiveRecord::Result.new(processed_rows.first&.keys || [], processed_rows)
  end
  # 替换原有exec_query方法
  alias_method_chain :exec_query, :skip_legacy_field
end

• 全局修改ActiveSupport时间解析逻辑：异常抛出点在类型反序列化完成后的utc方法调用环节，根本不会走到ActiveSupport的时间解析分支，修改自然不生效
• 模型内加rescue_from捕获异常：异常发生在结果集转模型实例之前，模型层的错误拦截机制完全接触不到该位置的异常
• 全局替换所有DateTime字段为字符串类型：会破坏其他正常时间字段的解析逻辑，引入大量额外问题

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