使用createCustomToken()遇auth/email-already-exists，如何允许同一邮箱多账户？

Firebase Auth默认强制邮箱地址唯一，直接将相同邮箱设置到不同用户的email字段会触发auth/email-already-exists错误。针对主/子账户共享邮箱的场景，可通过以下两种方案解决：

方案1：将邮箱存储到自定义Claims而非用户email字段 #

这是最直接的方案，绕过Firebase的邮箱唯一性校验：

• 保留现有邮箱验证码流程：用户提交邮箱后，后台发送一次性验证码，验证通过后再生成自定义令牌。
• 生成自定义令牌时，将已验证的邮箱存入自定义Claims，而非设置为用户的email属性。

示例代码（Node.js Admin SDK）：

// 假设已完成邮箱验证码验证，verifiedEmail是用户提交的邮箱，uid是子账户的唯一ID
admin.auth().createCustomToken(uid, {
  verifiedEmail: verifiedEmail,
  accountType: 'child' // 标记账户类型，方便后续业务区分
})
.then(customToken => {
  // 将customToken返回给客户端，用于signInWithCustomToken
})
.catch(error => {
  console.error('生成自定义令牌失败:', error);
});

用户登录后，可通过currentUser.getIdTokenResult()获取自定义Claims中的邮箱信息，用于业务逻辑处理。

方案2：为邮箱添加唯一后缀（兼容Firebase原生邮箱功能） #

如果需要使用Firebase的邮箱验证、密码重置等原生功能，可通过邮箱后缀区分不同账户：

• 用户提交原邮箱（如parent@example.com）后，后台为不同账户生成带唯一标识的邮箱后缀，比如parent+child_123@example.com（child_123为子账户ID）。
• 验证码仍发送到原邮箱（主流邮箱服务商支持+后缀，邮件会正常投递到原邮箱收件箱）。
• 生成自定义令牌时，将带后缀的邮箱设置为用户的email属性，Firebase会判定为不同邮箱，不会触发唯一性错误。

注意：这种方式需要在业务层统一处理后缀逻辑，展示给用户的始终是原邮箱，避免用户困惑。

关键注意事项 #

• 无论哪种方案，邮箱验证流程必须自行实现（不能依赖Firebase的sendEmailVerification），确保只有通过验证码验证的邮箱才能关联到账户。
• 自定义Claims中的邮箱信息仅用于业务逻辑，无法直接触发Firebase的邮箱相关原生功能（如密码重置），若需此类功能优先选择方案2。

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