如何编写Algolia API嵌套字段过滤器实现课程州筛选？

我需要在网站中通过用户选择的州筛选可用课程，使用Algolia实现搜索功能。以下是我的Algolia条目示例：

{
  "id": 4,
  "title": "again",
  "description": "Hello do you see me",
  "author": "cool",
  "level": "Advanced",
  "type": "Live Course",
  "price": 7700,
  "trial": false,
  "practice_areas": [
    {
      "id": 1,
      "name": "Cool"
    }
  ],
  "cle_credits": [
    {
      "id": 3,
      "credits": 12,
      "state": {
        "id": 1,
        "name": "Kentucky"
      },
      "cle_type": {
        "id": 2,
        "name": "Paralegal"
      }
    },
    {
      "id": 4,
      "credits": 56,
      "state": {
        "id": 2,
        "name": "Kansas"
      },
      "cle_type": {
        "id": 1,
        "name": "Ethics"
      }
    }
  ],
  "objectID": "4"
}

我尝试了以下两种API URL过滤器，但均无效：

• &currentPage=0&filters=state:Kansas
• &currentPage=0&filters=cle_credits.state.name:Kansas

以下是我构建搜索URL的代码：

export const getSearchUrl = ({
                               currentPage,
                               type,
                               level,
                               states,
                               selectedPracticeArea
                             }: {
  currentPage?: number;
  type?: string;
  level?: string;
  states: string[];
  selectedPracticeArea: string[];
}) => {
  let url = '';
  let filters: string[] = [];

  if (currentPage || currentPage === 0) {
    url += `&currentPage=${currentPage}`;
  }

  if (type) {
    url += `&type=${type}`;
  }

  if (level) {
    url += `&level=${level}`;
  }

  if (states.length > 0) {
    const stateFilters = states
      .map(state => `cle_credits.state.name:${state}`)
      .join(' OR ');
    filters.push(`${stateFilters}`);
  }

  if (selectedPracticeArea.length > 0) {
    const practiceFilters = selectedPracticeArea
      .map(practice => `practice_areas.name:"${practice}"`)
      .join(' OR ');
    filters.push(`(${practiceFilters})`);
  }

  if (filters.length > 0) {
    url += `&filters=${encodeURIComponent(filters.join(' AND '))}`;
  }

  console.log('url', url);

  return url;
};

请问如何修复该问题，以实现正确的州筛选功能？

解决方案 #

1. 修正筛选语法 #

Algolia对数组中的嵌套对象属性筛选需要使用contains操作符，用来检查数组中是否存在满足条件的元素。之前直接访问cle_credits.state.name的写法会被当成扁平属性，无法正确匹配数组内的对象。

正确的筛选格式应为：

cle_credits:contains(state.name:"Kansas")

2. 确保属性可筛选 #

登录Algolia控制台，进入目标索引的设置页面：

• 找到**筛选器（Filtering）**板块
• 将cle_credits.state.name添加到**可筛选属性（Filterable Attributes）**列表中
• 保存设置并重新构建索引

3. 修改URL构建代码 #

更新getSearchUrl函数中处理states的逻辑，替换为正确的筛选语法：

// 修改后的states处理逻辑
if (states.length > 0) {
  const stateFilters = states
    .map(state => `cle_credits:contains(state.name:"${state}")`)
    .join(' OR ');
  filters.push(`(${stateFilters})`);
}

验证修改 #

修改后，当用户选择Kansas时，生成的filters参数会是：

filters=(cle_credits:contains(state.name:"Kansas"))

该条件会正确匹配所有cle_credits数组中存在state.name为Kansas的课程条目。

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