Rails+PostgreSQL 11环境下使用Scenic非物化视图查询时出现PG::InvalidTextRepresentation异常排查

这问题确实够诡异的，结合你描述的所有现象，我梳理了几个最有可能的原因和对应的排查/解决方向：

1. PostgreSQL 查询计划/类型推断缓存异常 #

PostgreSQL 会缓存查询计划和表/视图的统计信息，有时候如果视图里的 JSON 字段类型在首次生成计划时被误判（比如某个临时场景下生成的 name 是整数类型），后续查询就会沿用错误的类型推断。而你多次重试后恢复，可能是缓存过期或者重新生成了正确的计划。

• 排查/解决动作：
  • 登录生产数据库，手动更新视图的统计信息：ANALYZE formatted_bookings;
  • 检查生成 places 的子视图定义，确保 jsonb_build_object 里的 name 字段被强制转为字符串类型，比如用 COALESCE(your_source_name_field::text, 'null') 代替直接取字段值，从根源避免类型歧义
  • 临时测试时，可以在查询前执行 SET enable_plan_cache = off;（仅限测试，不要长期开启），看是否能避免报错

2. Scenic 视图定义的一致性问题 #

虽然你说本地和生产环境配置一致，但有可能生产环境的视图定义在某次部署中没有正确更新，或者 App Engine 的多实例中存在新旧视图定义共存的情况（比如某个旧实例还在使用未更新的视图）。

• 排查/解决动作：
  • 直接在生产数据库中查询视图定义，和本地对比：

    SELECT definition FROM pg_views WHERE viewname = 'formatted_bookings';
    

  • 确认生产环境的迁移脚本完全执行：rails db:migrate:status，检查 Scenic 相关的迁移是否标记为 up
  • 部署后重启所有 App Engine 实例，确保所有实例加载最新的视图定义

3. ActiveRecord 类型缓存错误 #

Rails 的 ActiveRecord 会缓存数据库表/视图的字段类型信息，如果首次查询时因为某种原因（比如临时数据异常）把 places 里的 name 推断成了整数，后续查询就会沿用这个错误的类型映射。而多次重试后恢复，可能是缓存被清空或重新加载了。

• 排查/解决动作：
  • 在 FormattedBooking 模型中显式指定 places 字段的类型，避免自动推断错误：

    class FormattedBooking < ApplicationRecord
      self.table_name = 'formatted_bookings'
      attribute :places, :jsonb
    end
    

  • 在生产 Rails 控制台中执行 FormattedBooking.reset_column_information，强制刷新字段类型缓存，然后再执行查询测试

4. 临时数据异常（概率较低，但值得排查） #

虽然你把生产库同步到本地后一切正常，但不排除生产环境在某个特定时刻，生成 places 的源数据中出现了整数类型的 name 值，导致首次查询时视图返回的 JSON 里 name 是整数，触发了类型错误，后续数据被修正后查询恢复正常。

• 排查/解决动作：
  • 检查生成 places 的子视图对应的源表，看是否存在 name 字段类型不一致或值为整数的记录
  • 查看生产数据库的查询日志，找到报错时刻的具体 SQL 和返回数据，确认当时的 places 内容是否有异常

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