Rails 5.1.5更新关联对象报错：TypeError无法转换PostgreSQL数组数据

我之前也踩过这个坑——在开发环境用Rails控制台更新Puzzle对象的关联User时，数据库直接ROLLBACK，还抛出TypeError: can't cast ActiveRecord::ConnectionAdapters::PostgreSQL::OID::Array::Data的错误。最诡异的是，初始创建Puzzle时设置关联User完全正常，只有后续用update方法（或者先puzzle.user = some_user再save）才会触发问题。

问题根源分析 #

这个错误基本和模型里的数组类型字段处理有关。大概率是你的Puzzle或User模型中，有数组类型的属性（比如tags、allowed_users这类字段），在更新关联时，Rails的参数序列化出了问题，把数组对象转换成了PostgreSQL内部的Array::Data类型，而ActiveRecord没法正确将其转换为数据库可识别的格式。

具体解决方案 #

1. 移除数组字段的serialize声明（最常见原因） #

很多人会习惯性给数组字段加serialize :xxx, Array，但PostgreSQL原生支持数组类型，Rails已经内置了处理逻辑，额外的serialize反而会导致序列化冲突。

比如之前的错误模型定义：

class Puzzle < ApplicationRecord
  belongs_to :user
  serialize :tags, Array # 这里是坑！
end

直接移除serialize这一行，确保你的数据库迁移是正确定义数组类型的：

# 对应的迁移文件示例
def change
  add_column :puzzles, :tags, :string, array: true, default: []
end

修改后重启Rails控制台，再尝试更新关联操作。

2. 检查更新时的参数传递逻辑 #

如果是用update方法批量传参，比如：

puzzle.update(user: User.find(1), tags: ["easy", "math"])

有时候参数格式错误（比如不小心把数组字段值传成了PostgreSQL的内部对象）也会触发错误。可以分步操作排查：

puzzle = Puzzle.find(1)
puzzle.user = User.find(2)
# 先检查所有属性，重点看数组字段的类型
puts puzzle.attributes
puzzle.save!

如果发现数组字段的值是ActiveRecord::ConnectionAdapters::PostgreSQL::OID::Array::Data类型，那肯定是模型定义的问题，回到第一步修正。

3. 更新pg gem版本 #

旧版本的Rails（比如5.x早期）和pg gem之间存在数组序列化的兼容性bug。可以尝试更新到最新稳定版：

# 修改Gemfile
gem 'pg', '~> 1.5'
# 执行更新
bundle update pg

更新后重启服务器和控制台，再测试更新操作。

4. 临时手动转换数组格式（应急方案） #

如果暂时没法修改模型或依赖版本，可以在保存前手动把异常的数组对象转成普通Ruby数组：

puzzle = Puzzle.find(1)
puzzle.user = User.find(2)
# 假设问题字段是tags
puzzle.tags = puzzle.tags.to_a if puzzle.tags.is_a?(ActiveRecord::ConnectionAdapters::PostgreSQL::OID::Array::Data)
puzzle.save!

不过这只是临时 workaround，还是建议从根源上修正模型定义。

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