Firebase Functions中auth.generateEmailVerificationLink生成错误APIKey问题

核心问题 #

生产环境（本地测试/托管部署）中调用auth.generateEmailVerificationLink()生成的验证链接，使用了前端Google Maps的API Key而非Firebase项目默认API Key，导致验证时出现以下错误：

Try verifying your email again
Your request to verify your email has expired or the link has already been used

手动替换链接中的API Key为正确值后验证可正常完成，且在GCP凭据页面删除旧Maps API Key后，问题仍持续存在。

可能原因 #

Admin SDK初始化时未正确获取项目默认凭据，而是读取了残留的错误配置：

• 本地.env文件存在指向Maps API Key的环境变量（如GOOGLE_API_KEY、API_KEY）
• GCP Cloud Functions的环境变量中配置了错误的API Key参数
• Firebase CLI缓存或Cloud Functions部署缓存未更新，仍保留旧配置
• 项目配置文件（如firebase.json）存在遗留的API Key设置

解决步骤 #

1. 清理本地环境配置 #

• 检查项目根目录的.env文件，删除所有与Maps API Key相关的变量
• 重启本地Functions服务，确保新配置生效

2. 检查GCP环境变量 #

• 进入GCP控制台的Cloud Functions页面，找到目标函数
• 进入「编辑」→「运行时、构建、连接设置」→「环境变量」，删除所有错误的API Key配置项

3. 重置Firebase CLI凭据 #

• 执行命令清除本地缓存并重新登录：

  firebase logout && firebase login
  

• 若之前通过functions:config设置过错误参数，执行：

  firebase functions:config:unset apiKey
  

4. 强制重新部署函数 #

• 使用--force参数跳过缓存，确保部署最新配置：

  firebase deploy --only functions --force
  

5. 验证Admin SDK初始化 #

• 确认初始化代码为无参数调用，并添加日志验证API Key：

  import { initializeApp } from 'firebase-admin/app';
  const app = initializeApp();
  // 日志输出当前API Key，验证是否与项目默认值一致
  console.log('Current Firebase API Key:', app.options.apiKey);
  

验证方法 #

生成验证链接后，打印链接内容，检查apiKey参数是否与Firebase控制台（项目设置→常规）中的默认API Key一致，确认无误后测试邮箱验证流程。

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