如何在Algolia索引空搜索时返回空结果？

你可以通过预查询判断处理后的搜索词是否为空来实现需求，无需自己维护停用词词典。核心思路是利用Algolia返回的query字段（该字段会返回经过停用词移除等处理后的最终搜索词），先发起一个轻量的预查询，根据处理后的query是否为空来决定返回空结果还是执行实际搜索。

实现代码 #

// 处理前端传入的搜索词，默认为空字符串
const processedSearchTerm = search ?? '';

// 第一步：发起轻量预查询，仅获取查询元数据（不返回实际结果）
const preQueryResult = await productsIndex.search<Product>(processedSearchTerm, {
  hitsPerPage: 0, // 不返回命中结果，大幅减少请求数据量
  filters, // 保持和实际搜索一致的过滤条件
  // 如果你是在全局索引配置中启用的removeStopWords，这里可以省略；如果是单请求配置，需要加上
  removeStopWords: true,
});

// 判断处理后的搜索词是否为空
if (preQueryResult.query.trim() === '') {
  // 处理后无有效搜索词，直接返回空结果
  return { hits: [], nbPages: 0, page: decodedEsk ? decodedEsk.page : 0 };
}

// 第二步：处理后有有效搜索词，执行实际搜索
const { hits, nbPages, page } = await productsIndex.search<Product>(processedSearchTerm, {
  hitsPerPage: limit,
  filters,
  page: decodedEsk ? decodedEsk.page : undefined,
});

return { hits, nbPages, page };

关键说明 #

1. 预查询的优势：使用hitsPerPage: 0的请求非常轻量，仅返回查询的元数据（包括处理后的query字段），不会占用额外的带宽或索引资源。
2. 对齐配置：确保预查询的配置（如removeStopWords、filters）和实际搜索完全一致，避免出现处理逻辑不一致的情况。
3. 直接返回空结果：当处理后的query为空时，直接返回空数组，无需调用实际搜索接口，避免返回全量记录。

替代优化方案（单请求实现） #

如果不想发起两次请求，也可以在一次搜索中处理，通过判断返回的query是否为空来覆盖结果：

const { hits, nbPages, page, query } = await productsIndex.search<Product>(search ?? '', {
  hitsPerPage: limit,
  filters,
  page: decodedEsk ? decodedEsk.page : undefined,
});

// 若处理后的搜索词为空，返回空结果
if (query.trim() === '') {
  return { hits: [], nbPages: 0, page: decodedEsk ? decodedEsk.page : 0 };
}

return { hits, nbPages, page };

注意：此方案会在处理后的query为空时先获取全量记录再丢弃，仅适合数据量较小的索引，否则会浪费资源。

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