Docusaurus集成Algolia后搜索无结果，后台索引测试正常

已确认Algolia后台索引正常，但站点内搜索无结果，可按以下步骤排查：

• 检查API Key类型：确保配置里的apiKey是Algolia后台的「Search-Only API Key」，而非爬虫用的Admin Key。Admin Key权限过高，前端调用会被拦截，必须使用仅具备搜索权限的Key。
• 核对索引名称：确认indexName与Algolia后台的索引名称完全一致，包括大小写、特殊字符，哪怕差一个字符都可能导致无法匹配。
• 验证环境与索引的匹配性：如果是本地开发环境，检查爬虫爬取的是本地站点还是线上站点。若爬虫爬的是线上，本地站点路径与线上不一致会导致搜索结果过滤失效，可尝试部署线上后测试，或修改爬虫配置爬取本地运行的站点（需保证本地站点处于启动状态）。
• 临时关闭Contextual Search：当前开启了contextualSearch: true，该功能会根据当前页面路径过滤结果，若路径不匹配索引中的url字段会返回空。先将其设为false测试，若能搜到结果，再排查路径匹配问题。
• 查看浏览器控制台报错：搜索时打开浏览器F12控制台，查看是否有401（权限错误）、404（索引不存在）等报错，这些信息能直接定位问题根源。
• 检查索引字段完整性：在Algolia后台查看索引记录，确认每条数据都包含url、title、content等核心字段，Docusaurus搜索依赖这些字段，缺失会导致无法正常检索。

内容的提问来源于stack exchange，提问作者Remo H. Jansen