Strapi中AND与OR组合查询异常：多词搜索结果不符预期

需求回顾 #

实现多词搜索，要求所有搜索词必须各自匹配Name、Specialty、City中的至少一个字段：

• 搜索“Dallas chiropractor”：需返回「Dallas匹配City」且「chiropractor匹配Specialty」的结果
• 搜索“Jones Dentist”：需返回「Jones匹配Name」且「Dentist匹配Specialty」的结果

当前代码的问题 #

你参考的$and嵌套$or思路是正确的，但生成URL参数时包含了换行和缩进空格，这些字符会被URL编码为%20或%0A，导致Strapi无法正确解析过滤条件的层级结构，最终出现仅匹配最后一个字段的异常。

正确实现代码 #

移除参数字符串中的换行和空格，确保参数格式符合Strapi的URL过滤规则：

let urlTerms = `&pagination[pageSize]=${pageSize}&pagination[page]=${page}&`;
urlTerms += terms
  .filter(term => term.trim() !== '') // 过滤空字符串，避免无效参数
  .map((term, i) => 
    `filters[$and][${i}][$or][0][Name][$containsi]=${encodeURIComponent(term)}&filters[$and][${i}][$or][1][Specialty][$containsi]=${encodeURIComponent(term)}&filters[$and][${i}][$or][2][City][$containsi]=${encodeURIComponent(term)}`
  )
  .join('&');

关键优化点 #

1. 移除换行/空格：确保每个过滤参数是连续的有效字符串，避免解析错误
2. 过滤空term：用filter去掉空字符串，防止生成无效的$and项
3. URL编码：用encodeURIComponent()处理搜索词，避免特殊字符（如空格、&）破坏参数结构

生成的正确查询示例 #

以搜索“Dallas chiropractor”为例，生成的参数结构如下：

&pagination[pageSize]=20&pagination[page]=1&filters[$and][0][$or][0][Name][$containsi]=Dallas&filters[$and][0][$or][1][Specialty][$containsi]=Dallas&filters[$and][0][$or][2][City][$containsi]=Dallas&filters[$and][1][$or][0][Name][$containsi]=chiropractor&filters[$and][1][$or][1][Specialty][$containsi]=chiropractor&filters[$and][1][$or][2][City][$containsi]=chiropractor

这个结构会被Strapi正确解析为：

(Name包含Dallas 或 Specialty包含Dallas 或 City包含Dallas) 且 (Name包含chiropractor 或 Specialty包含chiropractor 或 City包含chiropractor)

完全符合“所有词均匹配至少一个字段”的需求。

额外说明 #

如果需要支持多词短语匹配（比如“Grand Rapids”作为整体匹配City字段），则需要调整分词逻辑，允许用户通过引号等方式标记短语，再单独处理短语的匹配条件，例如：

• 识别带引号的短语，直接生成City[$containsi]="Grand Rapids"的条件，而非拆分为两个独立term

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