Firebase Admin Node.js SDK 中更新邮件登录链接域名的配置方法

Firebase Admin Node.js SDK 是开发者管理 Firebase 后端服务的重要工具。在用户认证场景中，通过邮件发送登录链接是一种常见的无密码登录方式。本文将详细介绍如何配置自定义域名用于生成这些登录链接。

背景与需求

传统上，Firebase 使用动态链接(Dynamic Links)服务来处理邮件登录链接。但随着业务发展，许多开发者希望使用自己的 Firebase 托管域名来替代这一功能，以获得更好的控制权和品牌一致性。

解决方案

Firebase Admin Node.js SDK 从 13.1.0 版本开始，提供了通过 projectConfigManager.updateProjectConfig() 方法更新移动链接配置的能力。开发者可以通过设置 mobileLinksConfig 参数来指定自定义域名。

具体实现

要配置自定义域名，开发者需要：

1. 确保已升级到 Firebase Admin SDK 13.1.0 或更高版本
2. 准备一个有效的 Firebase 托管域名
3. 使用以下代码更新项目配置：

const updateRequest = {
  mobileLinksConfig: {
    domain: '你的Firebase托管域名'
  }
};

admin.auth().projectConfigManager()
  .updateProjectConfig(updateRequest)
  .then((response) => {
    console.log('项目配置更新成功');
  })
  .catch((error) => {
    console.error('更新项目配置时出错:', error);
  });

注意事项

1. 域名必须已经正确设置并验证过所有权
2. 更改可能需要几分钟才能生效
3. 确保所有相关服务(如邮件模板)都已更新以反映这一变更
4. 测试新的登录链接在各种邮件客户端中的表现

迁移建议

对于正在从动态链接迁移的开发者，建议：

1. 先在小规模用户中测试新配置
2. 保留旧配置一段时间以确保平稳过渡
3. 监控登录成功率以确认迁移效果
4. 更新相关文档和用户指引