Firebase账户激活/重置密码邮件API密钥错误问题排查与解决

问题根源 #

• Firebase与关联GCP项目的密钥配置串了：Firebase属于GCP生态，若在GCP控制台把Google Maps的API密钥误设为Firebase Auth的默认调用密钥，会导致自动生成的邮件链接用错密钥
• 自定义邮件模板配置错误：如果之前手动修改过Auth邮件模板，替换了默认的{{actionUrl}}变量或硬编码了错误的API密钥，就会出现这个问题
• GCP Identity Platform配置异常：Firebase Auth底层依赖GCP Identity Platform，若在GCP身份平台设置里填写了错误的API密钥，也会引发该问题

排查修复步骤 #

1. 核对Firebase项目的API密钥
   打开Firebase控制台，进入项目→「项目设置」→「常规」，找到Web应用的配置代码，确认其中的apiKey为正确的Firebase密钥。接着跳转到GCP控制台的「API和服务」→「凭据」页面，找到Firebase自动创建的浏览器密钥（标注为「Browser key (auto created by Firebase)」），确保该密钥与应用中使用的一致，同时禁用或删除误用到的Maps密钥。

2. 重置Auth邮件模板
   进入Firebase控制台→「认证」→「模板」，选中出问题的验证邮件或重置密码模板，点击「恢复默认」，让系统重新生成标准模板。若需自定义模板，必须使用Firebase提供的{{actionUrl}}变量生成链接，禁止手动写死API密钥。

3. 检查GCP Identity Platform配置
   打开GCP控制台对应项目→「身份平台」→「设置」→「通用」，查看「API密钥」选项，确保此处填写的是Firebase项目的正确密钥，而非Maps的密钥。

4. 重新部署并测试
   重新部署Web应用，确保最新配置生效。随后发送一封新的验证/重置邮件，检查链接中的apiKey参数是否与Firebase项目的密钥一致。

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