查询PostgreSQL视图时Active Record日期转换不一致问题

问题根源 #

你的场景核心矛盾是：

• PostgreSQL数据库时区配置为Europe/London，但你存储的timestamp without time zone字段值实际为UTC时间
• ActiveRecord默认会将timestamp without time zone类型的字段值按照数据库时区解析，再转换为应用时区的时间，由此产生了多余的偏移
• appointment类型的时间由于精度匹配表字段定义，走了Rails预设的无转换逻辑，而schedule类型动态生成的时间精度与表字段不一致，触发了多余的时区转换

解决方案 #

方案一：修改数据库会话时区（最推荐，全局统一逻辑） #

直接在config/database.yml中配置PostgreSQL会话时区为UTC，让ActiveRecord读取所有timestamp without time zone字段时都按UTC解析，完全对齐你存储数据的规则：

default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  # 新增以下配置
  variables:
    timezone: 'UTC'

改完重启应用即可生效，所有时间读取逻辑都会统一，不需要额外修改模型或视图。

方案二：视图模型显式指定字段时区 #

如果不方便修改全局数据库配置，可以单独为日历事件视图的模型指定starts_at字段按UTC解析：

Rails 7+ 版本

直接使用attribute方法的time_zone参数：

class CalendarEvent < ApplicationRecord
  # scenic生成的视图需标记为只读
  self.readonly = true
  attribute :starts_at, :datetime, time_zone: "UTC"
end

Rails 6及更低版本

自定义类型转换器跳过多余的时区转换：

class CalendarEvent < ApplicationRecord
  self.readonly = true
  # 自定义UTC时间转换器
  class UtcDateTimeType < ActiveRecord::Type::DateTime
    def deserialize(value)
      return value if value.is_a?(Time)
      Time.find_zone!("UTC").parse(value)
    end
  end
  attribute :starts_at, UtcDateTimeType.new
end

方案三：修正视图SQL的字段精度 #

如果问题出在UNION查询的字段类型元信息不匹配，可以修改视图中schedule部分的starts_at生成逻辑，强制对齐appointments表的精度：

(
  SELECT
    'schedule' AS event_type,
    (
      to_timestamp(
        CONCAT(
          start_date,
          ' ',
          lpad(start_hour :: text, 2, '0'),
          ':',
          lpad(start_minute :: text, 2, '0'),
          ':00.000000'
        ),
        'YYYY-MM-DD hh24:mi:ss.us'
      ) at time zone 'UTC'
    ) :: timestamp(6) without time zone AS starts_at
  FROM
    schedule_items
)

显式指定为timestamp(6)和appointments表的字段精度完全一致，避免ActiveRecord识别类型异常。

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