Drupal 9集成Algolia搜索时Facets无法过滤搜索结果求助

• 对齐Facet源的Filter Key
  把Facet源的「Filter key」设置为type（和Algolia后台的「Type」字段名匹配，注意小写）。Drupal的Facets模块需要这个键来关联Algolia的facet字段，未设置时无法正确传递过滤参数。

• 确保视图添加了Facet过滤器
  打开你的「Index Algolia index」类型视图，添加「Search API: Facets」过滤器，并勾选对应的「Content Type」选项。该过滤器负责将facet点击的参数传递给Algolia查询，缺失的话点击操作不会触发过滤逻辑。

• 验证Algolia索引的Facet配置
  再次确认Algolia后台的「Type」字段已开启facet功能，且字段类型为字符串。同时检查Drupal的Search API索引中，「Content Type」字段是否正确映射到Algolia的「Type」字段。

• 清理Drupal缓存
  修改配置后执行缓存清理（可通过drush cr命令或后台「配置」-「性能」页面操作），缓存残留可能导致新配置无法生效。

• 检查URL参数传递
  点击facet后查看浏览器地址栏，正常情况下会出现类似?f[0]=type:page的参数。如果没有该参数，需检查Facet区块配置中的「Query parameter」设置，确保参数名正确（默认是f）。

• 确认模块版本兼容性
  确保Search API Algolia（≥3.x）和Facets（≥2.x）模块为Drupal 9兼容的稳定版本，避免因版本冲突导致功能异常。

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