升级Rails 5+弃用postgres_ext：数组IN查询错误修复及适配要点

一、当前数组查询错误的修复 #

错误原因 #

你的block_titles是PostgreSQL数组类型字段，移除postgres_ext后，直接将数组传入find_or_create_by会导致ActiveRecord错误生成SQL语法：把数组拆成IN ('', 'xxx')的形式，而PostgreSQL要求数组字面量必须用{}包裹，因此触发PG::InvalidTextRepresentation错误。

修复步骤 #

1. 调整查询语法
   替换原有的find_or_create_by写法，改用PostgreSQL原生数组操作符构建查询：

   # 根据业务需求过滤数组中的空字符串（避免无效查询）
   filtered_block_titles = section[:block_titles].reject(&:blank?)
   # 用@>操作符匹配数组包含所有指定值的记录，或用&&匹配包含任意值的记录
   matching_section = company.sections
     .where("block_titles @> ARRAY[?]::varchar[]", filtered_block_titles)
     .where(section.except(:block_titles))
     .first
   
   # 找不到则创建新记录
   matching_section || company.sections.create(section)
   

2. 模型字段定义标准化
   在Section模型中用Rails原生语法定义数组字段，替代postgres_ext的处理：

   class Section < ApplicationRecord
     attribute :block_titles, :string, array: true, default: []
     # 其他模型代码...
   

二、Rails 5+升级的适配改动 #

1. 移除postgres_ext依赖 #

Rails 5+原生支持PostgreSQL的数组、JSON、HStore等扩展类型，直接删除Gemfile中的postgres_ext，执行bundle install清理依赖。

2. 替换postgres_ext专属功能 #

• 原postgres_ext提供的where_array、order_array等查询方法，改用Rails原生查询或Arel构建：

  # 原postgres_ext写法：where_array(:block_titles, ['a', 'b'])
  # 替换为：
  where("block_titles && ARRAY[?]::varchar[]", ['a', 'b'])
  

• 原postgres_ext的迁移语法（如t.string :tags, array: true），Rails 5+已支持，无需改动，但要确保迁移中字段定义正确。

3. 处理ActiveRecord核心变化 #

• belongs_to关联默认变为必填，若模型中有可选关联，需添加optional: true：

  belongs_to :company, optional: true
  

• find_or_create_by的返回值逻辑调整，复杂查询建议拆分where+first_or_create避免歧义。

4. 升级其他依赖 #

检查项目中所有Gem的版本兼容性，确保它们支持Rails 5+（如devise、pundit、rspec-rails等），必要时升级对应Gem版本。

5. 全面测试与问题排查 #

• 运行所有单元/集成测试，重点检查数组、JSON等特殊字段的查询、创建、更新逻辑。
• 排查控制台中的 deprecation warning，逐步修复过时语法。

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