如何在Dart Firebase中修改Firestore及身份认证内的用户邮箱与密码？

核心规则 #

• 操作顺序固定：先更新Firebase Auth的数据，更新成功后再写入Firestore，避免出现Auth侧未修改、Firestore先更新导致的登录异常
• 密码为敏感信息，禁止明文存储到Firestore，仅需更新Auth侧密码即可，不需要同步到Firestore
• 前端修改用户自身的邮箱/密码时，若用户登录时间超过5分钟，必须先调用reauthenticateWithCredential接口完成重认证，否则会触发权限拒绝错误

密码修改操作 #

前端（用户自助修改）代码示例 #

import { getAuth, updatePassword, reauthenticateWithCredential, EmailAuthProvider } from "firebase/auth";

const auth = getAuth();
const currentUser = auth.currentUser;

// 第一步：收集用户输入的旧密码完成重认证
const userCredential = EmailAuthProvider.credential(
  currentUser.email,
  "用户输入的旧密码"
);
await reauthenticateWithCredential(currentUser, userCredential);

// 第二步：更新Auth侧密码，无需同步到Firestore
await updatePassword(currentUser, "用户设置的新密码");

后端（管理员修改任意用户密码）代码示例 #

import { getAuth } from "firebase-admin/auth";

const auth = getAuth();
const targetUserUid = "待修改用户的UID";

// 直接调用Admin SDK更新Auth侧密码即可，无需操作Firestore
await auth.updateUser(targetUserUid, {
  password: "新密码"
});

邮箱修改操作 #

邮箱需要同步到Firestore，避免业务侧读取用户信息时出现新旧邮箱不一致的问题。

前端（用户自助修改）代码示例 #

import { getAuth, updateEmail, sendEmailVerification, reauthenticateWithCredential, EmailAuthProvider } from "firebase/auth";
import { getFirestore, doc, updateDoc } from "firebase/firestore";

const auth = getAuth();
const currentUser = auth.currentUser;
const db = getFirestore();
const newEmail = "用户输入的新邮箱";

// 第一步：完成重认证
const credential = EmailAuthProvider.credential(
  currentUser.email,
  "用户输入的当前密码"
);
await reauthenticateWithCredential(currentUser, credential);

// 第二步：更新Auth侧邮箱
await updateEmail(currentUser, newEmail);
// 可选：给新邮箱发送验证邮件
await sendEmailVerification(currentUser);

// 第三步：同步更新Firestore用户文档的邮箱字段
await updateDoc(doc(db, "users", currentUser.uid), {
  email: newEmail
});

后端（管理员修改任意用户邮箱）代码示例 #

import { getAuth } from "firebase-admin/auth";
import { getFirestore } from "firebase-admin/firestore";

const auth = getAuth();
const db = getFirestore();
const targetUserUid = "待修改用户的UID";
const newEmail = "新邮箱地址";

// 第一步：更新Auth侧邮箱
await auth.updateUser(targetUserUid, {
  email: newEmail,
  // 可选：如果确认邮箱归属无误，可直接标记为已验证，无需用户手动验证
  emailVerified: true
});

// 第二步：同步更新Firestore用户文档
await db.collection("users").doc(targetUserUid).update({
  email: newEmail
});

异常处理 #

若Auth更新成功但Firestore写入失败，必须触发回滚逻辑，将Auth侧的信息恢复为修改前的旧值，避免两边数据不一致。高可靠场景下可以通过事务、失败重试机制进一步降低数据不一致的概率。

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