GCP Identity Platform登录邮件链接缺失协议、主机名及路径的解决方法

核心原因分析 #

你的邮箱登录链接仅显示查询参数，说明Firebase无法正确获取或使用配置的authDomain生成完整URL。这通常是自定义域名未在Firebase控制台完成验证或配置导致的。

分步解决方案 #

1. 验证自定义authDomain的Firebase配置 #

确保auth.staging.developers.aptoslabs.com已在Firebase控制台完成以下配置：

• 进入Authentication → 登录方法 → 授权域名，确认该域名已被添加并启用。
• 进入Authentication → 设置 → 自定义域名，添加该域名并完成DNS验证（需在域名服务商处添加指定的TXT记录）。只有完成验证的自定义域名，Firebase才会用它生成邮件中的登录链接。

2. 检查默认邮件模板 #

虽然你未修改模板，但仍需确认模板中的链接格式正确：

• 进入Authentication → 模板 → 邮箱登录，查看默认模板的链接部分是否为：

  https://{{authDomain}}/__/auth/action?{{actionCodeQueryParams}}
  

  若{{authDomain}}占位符缺失或被修改，需重置为默认模板。

3. 确认环境变量与auth初始化正确性 #

• 再次验证process.env.NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN的值确实为auth.staging.developers.aptoslabs.com，避免环境变量未正确加载。
• 可临时切换为Firebase默认域名（如your-project-id.firebaseapp.com）测试，若链接恢复正常，即可确认问题出在自定义域名配置上。

4. 同步GCP Identity Platform与Firebase配置 #

由于你在GCP Identity Platform配置了localhost授权域名，需确认Firebase控制台的授权域名列表已同步该配置。可手动在Firebase控制台添加localhost域名，避免配置延迟。

测试验证 #

完成上述配置后，重新发送登录链接，邮件中的URL应变为：

https://auth.staging.developers.aptoslabs.com/__/auth/action?apiKey=<key>&mode=signIn&oobCode=<oob_code>&continueUrl=http://localhost:3000/complete-email-sign-in&lang=en

该链接会自动处理授权流程并跳转到你指定的continueUrl。

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