FlexSearch中如何实现文档字段多可选值的逻辑OR匹配查询

基于FlexSearch实现前端检索能力的应用中，已初始化的索引结构、检索条目数组如下：

let results = [
  { id:'a', name:'The title', status:'in-stock' },
  { id:'b', name:'Another title', status:'out-of-stock' },
  { id:'c', name:'Some other', status:'discontinued' },
];

const resultSchema = {
  id: 'id',
  field: [
    'name',
    'status'
  ]
};

const resultIndex = new FlexSearch({
  profile:'score',
  doc: resultSchema
});
resultIndex.add(results);

页面配置了对应三种商品状态（in-stock、out-of-stock、discontinued）的复选框筛选控件，当前需要实现的需求是：筛选出状态为in-stock 或 out-of-stock的全部匹配结果。
查阅where方法的相关说明时，未找到明确标注逻辑OR操作的实现路径。虽然理论上可以通过“排除状态为discontinued的结果”实现等价筛选，但由于当前检索索引并未覆盖业务全量数据集，无法依靠取反逻辑达成目标，需要明确FlexSearch框架内实现字段值逻辑OR组合筛选的正确方式。

内置原生支持（0.7.0及以上版本） #

FlexSearch的where查询逻辑本身就支持字段多值匹配，只需要给目标字段传入待匹配值数组，即可实现“匹配数组内任意一个值即返回对应结果”的OR逻辑，不需要额外拼接复杂的条件语句：

• 仅按字段取数、不涉及全文检索的场景：

// 直接返回所有状态为in-stock或out-of-stock的索引记录
const matchedResults = resultIndex.where({
  status: ['in-stock', 'out-of-stock']
});

• 需要结合全文检索、叠加字段筛选的场景：

// 搜索name字段包含关键词"title"，同时状态符合要求的结果
const searchResult = resultIndex.search("title", {
  limit: 100,
  where: {
    status: ['in-stock', 'out-of-stock']
  }
});

低版本兼容方案 #

如果使用的FlexSearch版本早于0.7.0，不支持数组形式的多值匹配，可以通过两次独立查询、按主键去重的方式实现等价OR逻辑：

// 分别查询两个状态的匹配结果
const inStockRes = resultIndex.where({ status: 'in-stock' });
const outStockRes = resultIndex.where({ status: 'out-of-stock' });
// 按唯一id合并去重，得到最终筛选结果
const finalMatched = [...new Map(
  [...inStockRes, ...outStockRes].map(item => [item.id, item])
).values()];

小提示：该兼容方案同样适用于结合全文检索的场景，只需要在两次查询时传入相同的搜索关键词，再做合并去重即可。

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