Firestore/Algolia集成失败：API密钥问题致扩展部署报错

应当使用的API密钥类型 #

必须使用Algolia Admin API Key，禁止使用Search-Only API Key：

• 这个扩展的核心作用是监听指定Firestore集合的文档新增、修改、删除事件，自动把变更同步到Algolia索引中，需要索引的写入、更新、删除权限；Search-Only API Key只有查询权限，根本支撑不了同步操作。
• 终端首次弹出提示里标注“供模拟器使用”的密钥输入项，本地调试阶段也得填Admin API Key，不然本地跑模拟器的时候，同步逻辑会因为权限不足跑不通。

API密钥的正确配置路径 #

你之前修改的extensions/firestore-algolia-search.secret.local是仅本地模拟器加载的本地专用配置，所有带.local后缀的扩展配置文件，在执行云端部署操作时都不会被CLI读取，这就是你改完密钥部署还是报相同错误的核心原因。正确配置方式选下面任意一种就行：

• 命令行交互式配置：在项目根目录执行下面的命令，跟着终端提示走，在要求输入ALGOLIA_API_KEY的时候填入正确的Admin API Key，保存后再执行部署命令即可。

firebase ext:configure firestore-algolia-search

• 手动改正式配置文件：打开项目根目录下extensions/firestore-algolia-search.env文件（注意别选带.local后缀的），新增或者修改对应的配置项：

ALGOLIA_API_KEY=你自己的Algolia Admin API密钥

保存文件后再执行firebase deploy --only extensions就能正常通过校验。

提醒：存API密钥的env文件属于敏感配置，不要提交到公开代码仓库。

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