Android端Firebase用户邮箱更新失败求助（附实现代码）

我碰到过不少开发者遇到这个问题，咱们一步步排查可能的原因，逐个解决：

1. 最常见原因：用户需要重新验证身份 #

Firebase对邮箱、密码这类敏感信息的修改有安全限制——用户必须是最近1小时内登录的。如果用户登录状态已经持续很久，令牌会失效，这时候必须先重新验证用户身份，再执行更新操作。

你可以在更新邮箱前，先调用reauthenticate方法验证用户当前的凭证，示例代码如下：

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user != null) {
    // 用用户当前的邮箱和密码创建凭证
    AuthCredential credential = EmailAuthProvider.getCredential(user.getEmail(), "用户当前登录密码");
    
    user.reauthenticate(credential)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                if (task.isSuccessful()) {
                    // 验证成功后，执行邮箱更新
                    user.updateEmail("user@example.com")
                        .addOnCompleteListener(new OnCompleteListener<Void>() {
                            @Override
                            public void onComplete(@NonNull Task<Void> task) {
                                if (task.isSuccessful()) {
                                    Log.d(TAG, "User email address updated.");
                                } else {
                                    // 打印更新失败的具体原因
                                    Log.e(TAG, "邮箱更新失败", task.getException());
                                }
                            }
                        });
                } else {
                    // 打印验证失败的原因（比如密码错误）
                    Log.e(TAG, "身份验证失败", task.getException());
                }
            }
        });
}

2. 一定要处理失败分支，打印错误日志 #

你的原始代码只处理了更新成功的情况，完全忽略了失败场景！这会导致你根本不知道问题出在哪——是邮箱被占用？网络问题？还是权限不足？

修改你的代码，加上失败分支的日志输出：

user.updateEmail("user@example.com")
    .addOnCompleteListener(new OnCompleteListener<Void>() {
        @Override
        public void onComplete(@NonNull Task<Void> task) {
            if (task.isSuccessful()) {
                Log.d(TAG, "User email address updated.");
            } else {
                // 关键：打印完整的异常信息，定位问题
                Log.e(TAG, "邮箱更新失败详情", task.getException());
            }
        }
    });

3. 确认用户实例有效 #

虽然你说用户已登录，但还是要确保getCurrentUser()返回的不是null，避免空指针或者无效实例的问题：

FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
if (user == null) {
    Log.d(TAG, "当前无有效登录用户");
    return;
}
// 后续更新操作

4. 检查Firebase Auth规则（极少情况，但值得确认） #

默认情况下，Firebase允许已认证用户修改自己的邮箱，但如果你自定义了Auth规则，可能不小心限制了这个操作。你可以在Firebase控制台的「Authentication」→「Rules」里确认规则是否允许：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if request.auth != null;
    }
  }
}

（注：这是默认规则，只要用户已认证就允许操作）

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