Flutter Firebase集成Apple登录无法获取用户邮箱及标识异常问题

为什么会出现邮箱显示差异？ #

• Apple登录时，用户有权选择是否隐藏真实邮箱：选隐藏的话，Apple会生成@privaterelay.appleid.com格式的隐私邮箱；选共享真实邮箱的话，Firebase直接拿到真实邮箱。
• 多数用户控制台「标识符」为空，核心是Apple登录授权流程没正确请求邮箱权限，或者用户首次授权时拒绝了权限。没有权限的话，Firebase拿不到邮箱信息，自然显示为空。
• 另外，Apple的隐私邮箱只在用户首次授权登录时返回一次，后续用户重复登录（无需重新授权）的话，Firebase不会再返回该邮箱，这也是部分用户拿不到的原因。

如何在用户注册时获取Apple邮箱？ #

1. 确保登录请求里加了邮箱权限 #

在Flutter的Apple登录配置中，必须明确添加email的scope，代码示例：

final appleProvider = AppleAuthProvider();
appleProvider.addScope('email');
// 如果需要用户名可以再加name scope
appleProvider.addScope('name');

final UserCredential credential = await FirebaseAuth.instance.signInWithProvider(appleProvider);

2. 首次登录时立刻存邮箱 #

只有用户第一次用Apple登录你的应用时，Apple才会返回邮箱（不管是真实还是隐私的），后续登录不会再返回。所以必须抓住首次登录的时机存到Firestore：

if (credential.additionalUserInfo?.isNewUser == true) {
  final user = credential.user;
  if (user?.email != null) {
    await FirebaseFirestore.instance.collection('users').doc(user.uid).set({
      'email': user.email,
      'createdAt': FieldValue.serverTimestamp(),
    });
  }
}

3. 处理用户拒绝权限的情况 #

如果用户首次登录时拒绝了邮箱权限，后续可以在应用内引导用户重新授权：

• 提示用户邮箱权限对账号功能的必要性
• 调用Apple重新授权流程，再次请求邮箱scope

4. 兜底重新加载用户数据 #

如果首次登录没拿到邮箱，也可以尝试重新加载Firebase用户数据，看看后续是否获取到了权限：

final user = FirebaseAuth.instance.currentUser;
await user?.reload();
final email = user?.email;
if (email != null) {
  // 更新Firestore里的用户数据
}

内容的提问来源于stack exchange，提问作者pcba-dev