Strapi数组过滤异常：使用qs处理参数筛选tags数组结果错误

问题场景 #

需要筛选出包含name为healthy的tags数组的条目，使用qs构造查询参数后返回结果不符合预期。

正确参数构造代码 #

import qs from 'qs';

// 构造筛选参数
const queryParams = qs.stringify({
  filters: {
    tags: {
      name: {
        $eq: 'healthy'
      }
    }
  }
}, { encodeValuesOnly: true });

关键说明 #

• Strapi对关联数组的筛选支持嵌套字段匹配，直接通过tags.name的层级结构指定过滤规则即可
• $eq用于精确匹配标签名称，若需模糊匹配可替换为$contains
• encodeValuesOnly: true参数能避免整个查询对象被过度编码，确保Strapi后端可以正确解析参数

最终生成的URL参数示例 #

?filters[tags][name][$eq]=healthy

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