Rails通过Postman提交嵌套JSON后filters字段查询为空的问题排查

• 核心原因1：Strong Parameters权限声明不匹配Hash结构类型
  Rails的Strong Parameters对嵌套结构参数的过滤逻辑是：如果只把:filters作为单标量键加入permit列表，当客户端传入的filters是嵌套Hash/数组结构时，框架会因为没有声明该键允许接收的子结构，直接把整个filters参数过滤为空，最终存入数据库的就是空Hash。这也是为什么创建接口虽然返回了创建成功的提示，但实际filters字段完全没有内容的核心原因。
• 次要原因2：模型层校验代码书写无效
  原模型中validates_each :filters的块代码完全没有按照块参数规范编写，块内部写的validates :filter, presence: true校验的是不存在的:filter字段（少了s后缀），既不能实现对filters字段的校验，还可能触发隐式的代码异常，干扰正常的保存逻辑。

1. 调整参数过滤规则，适配Hash类型的filters字段
   将原有的filter_group_params方法修改为符合Strong Parameters规范的写法，根据filters的结构特点选择对应声明方式：

def filter_group_params
  # 如果filters是完全动态的自定义键值对结构，用 filters: {} 声明允许接收嵌套Hash
  # 如果filters是固定结构（比如固定存field/operator/value这类筛选条件），则替换为具体子键列表：filters: [:field, :operator, :value]
  params.permit(:name, :app_id, filters: {})
end

2. 重写模型层的无效校验代码
   删除原模型中写法错误的validates_each块，替换为直接针对filters字段的校验逻辑：

class FilterGroup < ApplicationRecord
  # 声明filters字段为Hash类型序列化存储
  serialize :filters, Hash
  # 直接对filters字段做存在性校验，保证非空Hash才能通过校验
  validates :filters, presence: true

  belongs_to :user
  belongs_to :app
end

3. 排查兜底检查

• 确认filter_groups表中filters字段的数据库类型是text、json或jsonb，不能是短长度的string类型，否则序列化后的Hash内容会被截断，无法正常存储
• 修复后可以在create动作中打印参数日志，确认拿到的filter_group_params中filters字段是完整的传入内容，没有被框架过滤
• 重新创建测试用的筛选分组记录，调用索引接口验证filters字段是否能正确返回完整的嵌套内容

注：如果之前的旧记录是因为参数过滤问题生成的空filters，可以直接删除测试用的空记录重新创建即可，不需要做数据迁移。

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