Supabase Flutter集成中containedBy方法调用报错求助

问题场景 #

在Flutter项目集成Supabase时，尝试用containedBy方法过滤jobs表中关联字段city.country.id的数据，触发了Postgrest解析异常。

相关代码 #

var query = Supabase.instance.client.from('jobs').select(
    '*,city(name_ar,name_en,id,country!inner(id,name_ar,name_en)),job_category_rel:job_category_rel!inner(id, category!inner(id,name_ar,name_en))');
if (widget.countryList.isNotEmpty) {
  // TODO 根据国家ID过滤数据
  query = query.containedBy("city.country.id", widget.countryList);
}
final data = await query;

关键信息 #

• widget.countryList类型：List<int>
• 数据库中city.country.id字段类型：int8（即BigInt）

报错信息 #

Error fetching data: PostgrestException(message: "failed to parse filter (containedBy.{3})" (line 1, column 1), code: PGRST100, details: unexpected "c" expecting "not" or operator (eq, gt, ...), hint: null)

问题原因 #

containedBy是Postgrest针对数组类型字段设计的操作符，作用是判断字段的数组值是否是指定数组的子集。但这里city.country.id是单个整数类型，不是数组，用错了操作符才导致解析报错。

修复方案 #

改用in_操作符（因为in是Dart关键字，所以Supabase Dart客户端用in_替代），它对应SQL的IN语句，用于判断单个值是否存在于给定的列表中，完全匹配当前需求。

修改后的代码：

var query = Supabase.instance.client.from('jobs').select(
    '*,city(name_ar,name_en,id,country!inner(id,name_ar,name_en)),job_category_rel:job_category_rel!inner(id, category!inner(id,name_ar,name_en))');
if (widget.countryList.isNotEmpty) {
  // 根据国家ID过滤数据
  query = query.in_("city.country.id", widget.countryList);
}
final data = await query;

额外说明 #

• 如果你的数据库字段是数组类型（比如int[]），此时用containedBy才是正确的，比如判断tags数组是否包含在指定标签列表中：query.containedBy('tags', ['flutter', 'supabase'])
• in_操作符是处理“单个值在列表中”这类需求的标准方式，适配所有非数组类型的字段匹配。

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