在 Firebase 中管理用户

创建用户

如需在 Firebase 项目中创建新用户，您可以调用 createUserWithEmailAndPassword 方法，或让用户通过 Google 登录服务或 Facebook 登录服务等联合身份提供方服务完成首次登录。

您还可以前往 Firebase 控制台的“Authentication”部分，在“用户”页面中创建以密码验证身份的新用户，或者使用 Admin SDK 创建此类新用户。

获取当前登录的用户

如需获取当前用户，建议在 Auth 对象上设置一个观测器 (observer)：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth, onAuthStateChanged } from "firebase/auth";

const auth = getAuth();
onAuthStateChanged(auth, (user) => {
  if (user) {
    // User is signed in, see docs for a list of available properties
    // https://firebase.google.com/docs/reference/js/auth.user
    const uid = user.uid;
    // ...
  } else {
    // User is signed out
    // ...
  }
});
auth_state_listener.js

Web 命名空间型 API

firebase.auth().onAuthStateChanged((user) => {
  if (user) {
    // User is signed in, see docs for a list of available properties
    // https://firebase.google.com/docs/reference/js/v8/firebase.User
    var uid = user.uid;
    // ...
  } else {
    // User is signed out
    // ...
  }
});
index.js

使用观测器可确保在您获取当前用户时，Auth 对象不会处于中间状态（例如初始化）。当您使用 signInWithRedirect 时，onAuthStateChanged 观测器会等到 getRedirectResult 解析后再触发。

您还可以使用 currentUser 属性来获取当前登录的用户。如果用户并未登录，则 currentUser 为 null：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth } from "firebase/auth";

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

if (user) {
  // User is signed in, see docs for a list of available properties
  // https://firebase.google.com/docs/reference/js/auth.user
  // ...
} else {
  // No user is signed in.
}
auth_current_user.js

Web 命名空间型 API

const user = firebase.auth().currentUser;

if (user) {
  // User is signed in, see docs for a list of available properties
  // https://firebase.google.com/docs/reference/js/v8/firebase.User
  // ...
} else {
  // No user is signed in.
}
index.js

注意：currentUser 为 null 也可能是因为 auth 对象尚未完成初始化。如果您使用观测器跟踪用户的登录状态，则无需处理这种情况。

获取用户个人资料

如需获取用户的个人资料信息，请使用 User 实例的属性。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth } from "firebase/auth";

const auth = getAuth();
const user = auth.currentUser;
if (user !== null) {
  // The user object has basic properties such as display name, email, etc.
  const displayName = user.displayName;
  const email = user.email;
  const photoURL = user.photoURL;
  const emailVerified = user.emailVerified;

  // The user's ID, unique to the Firebase project. Do NOT use
  // this value to authenticate with your backend server, if
  // you have one. Use User.getToken() instead.
  const uid = user.uid;
}
auth_get_user_profile.js

Web 命名空间型 API

const user = firebase.auth().currentUser;
if (user !== null) {
  // The user object has basic properties such as display name, email, etc.
  const displayName = user.displayName;
  const email = user.email;
  const photoURL = user.photoURL;
  const emailVerified = user.emailVerified;

  // The user's ID, unique to the Firebase project. Do NOT use
  // this value to authenticate with your backend server, if
  // you have one. Use User.getIdToken() instead.
  const uid = user.uid;
}
manage.js

重要提示：设置（和稍后显示）可能向用户显示的界面值（如 displayName 和 photoURL）时，请务必小心。API 不会为了防范潜在的 XSS 类型攻击而对值进行过滤。

获取用户的特定提供方个人资料信息

如需获取从用户已关联的登录服务提供方检索到的个人资料信息，可使用 providerData 属性。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth } from "firebase/auth";

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

if (user !== null) {
  user.providerData.forEach((profile) => {
    console.log("Sign-in provider: " + profile.providerId);
    console.log("  Provider-specific UID: " + profile.uid);
    console.log("  Name: " + profile.displayName);
    console.log("  Email: " + profile.email);
    console.log("  Photo URL: " + profile.photoURL);
  });
}
auth_get_user_profile_provider.js

Web 命名空间型 API

const user = firebase.auth().currentUser;

if (user !== null) {
  user.providerData.forEach((profile) => {
    console.log("Sign-in provider: " + profile.providerId);
    console.log("  Provider-specific UID: " + profile.uid);
    console.log("  Name: " + profile.displayName);
    console.log("  Email: " + profile.email);
    console.log("  Photo URL: " + profile.photoURL);
  });
}
manage.js

更新用户个人资料

您可以使用 updateProfile 方法来更新用户的基本个人资料信息，即用户的显示名称和个人资料照片网址。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth, updateProfile } from "firebase/auth";
const auth = getAuth();
updateProfile(auth.currentUser, {
  displayName: "Jane Q. User", photoURL: "https://example.com/jane-q-user/profile.jpg"
}).then(() => {
  // Profile updated!
  // ...
}).catch((error) => {
  // An error occurred
  // ...
});
auth_update_user_profile.js

Web 命名空间型 API

const user = firebase.auth().currentUser;

user.updateProfile({
  displayName: "Jane Q. User",
  photoURL: "https://example.com/jane-q-user/profile.jpg"
}).then(() => {
  // Update successful
  // ...
}).catch((error) => {
  // An error occurred
  // ...
});  
manage.js

设置用户电子邮件地址

您可以使用 updateEmail 方法设置用户的电子邮件地址。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth, updateEmail } from "firebase/auth";
const auth = getAuth();
updateEmail(auth.currentUser, "[e-mail]").then(() => {
  // Email updated!
  // ...
}).catch((error) => {
  // An error occurred
  // ...
});
auth_update_user_email.js

Web 命名空间型 API

const user = firebase.auth().currentUser;

user.updateEmail("[e-mail]").then(() => {
  // Update successful
  // ...
}).catch((error) => {
  // An error occurred
  // ...
});
manage.js

重要提示：只能为最近登录过的用户设置电子邮件地址。请参阅重新对用户进行身份验证。

向用户发送验证电子邮件

您可以使用 sendEmailVerification 方法向用户发送地址验证电子邮件。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth, sendEmailVerification } from "firebase/auth";

const auth = getAuth();
sendEmailVerification(auth.currentUser)
  .then(() => {
    // Email verification sent!
    // ...
  });
auth_send_email_verification.js

Web 命名空间型 API

firebase.auth().currentUser.sendEmailVerification()
  .then(() => {
    // Email verification sent!
    // ...
  });
email.js

您可以在 Firebase 控制台的“Authentication”部分的“电子邮件模板”页面中自定义使用的电子邮件模板。请参阅 Firebase 帮助中心内的电子邮件模板。

在发送验证电子邮件时，还可以通过一个接续网址传递状态以重定向回应用。

此外，在发送验证电子邮件之前，您可以通过更新 Auth 实例中的语言代码来对该电子邮件进行本地化。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth } from "firebase/auth";

const auth = getAuth();
auth.languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// auth.useDeviceLanguage();
auth_set_language_code.js

Web 命名空间型 API

firebase.auth().languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// firebase.auth().useDeviceLanguage();
index.js

设置用户密码

您可以使用 updatePassword 方法设置用户密码。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

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

const auth = getAuth();

const user = auth.currentUser;
const newPassword = getASecureRandomPassword();

updatePassword(user, newPassword).then(() => {
  // Update successful.
}).catch((error) => {
  // An error ocurred
  // ...
});
auth_update_password.js

Web 命名空间型 API

const user = firebase.auth().currentUser;
const newPassword = getASecureRandomPassword();

user.updatePassword(newPassword).then(() => {
  // Update successful.
}).catch((error) => {
  // An error ocurred
  // ...
});
manage.js

重要提示：只能为最近登录过的用户设置密码。请参阅重新对用户进行身份验证。

发送重设密码电子邮件

您可以使用 sendPasswordResetEmail 方法向用户发送重设密码电子邮件。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth, sendPasswordResetEmail } from "firebase/auth";

const auth = getAuth();
sendPasswordResetEmail(auth, email)
  .then(() => {
    // Password reset email sent!
    // ..
  })
  .catch((error) => {
    const errorCode = error.code;
    const errorMessage = error.message;
    // ..
  });
auth_send_password_reset.js

Web 命名空间型 API

firebase.auth().sendPasswordResetEmail(email)
  .then(() => {
    // Password reset email sent!
    // ..
  })
  .catch((error) => {
    var errorCode = error.code;
    var errorMessage = error.message;
    // ..
  });
email.js

您可以在 Firebase 控制台的“Authentication”部分的“电子邮件模板”页面中自定义使用的电子邮件模板。请参阅 Firebase 帮助中心内的电子邮件模板。

在发送重设密码电子邮件时，还可以通过一个接续网址传递状态以重定向回应用。

此外，在发送重设密码电子邮件之前，您可以通过更新 Auth 实例中的语言代码来对该电子邮件进行本地化。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth } from "firebase/auth";

const auth = getAuth();
auth.languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// auth.useDeviceLanguage();
auth_set_language_code.js

Web 命名空间型 API

firebase.auth().languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// firebase.auth().useDeviceLanguage();
index.js

您也可以从 Firebase 控制台发送重设密码电子邮件。

删除用户

您可以使用 delete 方法删除用户帐号。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

import { getAuth, deleteUser } from "firebase/auth";

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

deleteUser(user).then(() => {
  // User deleted.
}).catch((error) => {
  // An error ocurred
  // ...
});
auth_delete_user.js

Web 命名空间型 API

const user = firebase.auth().currentUser;

user.delete().then(() => {
  // User deleted.
}).catch((error) => {
  // An error ocurred
  // ...
});
manage.js

重要提示：只能删除最近登录过的用户。请参阅重新对用户进行身份验证。

您还可以前往 Firebase 控制台的“Authentication”部分，在“用户”页面中删除用户。

重新对用户进行身份验证

某些涉及安全的敏感操作（例如删除帐号、设置主电子邮件地址和更改密码）只能针对最近登录过的用户执行。如果对长时间没有登录的用户执行这类操作，操作将失败并显示错误。发生这种情况时，请向用户索取新的登录凭据并将这些凭据传递给 reauthenticateWithCredential，以便重新对该用户进行身份验证。例如：

Web 模块化 API

详细了解可实现摇树优化的模块化 Web API，并从命名空间型 API 升级。

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

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

// TODO(you): prompt the user to re-provide their sign-in credentials
const credential = promptForCredentials();

reauthenticateWithCredential(user, credential).then(() => {
  // User re-authenticated.
}).catch((error) => {
  // An error ocurred
  // ...
});
auth_reauth_with_credential.js

Web 命名空间型 API

const user = firebase.auth().currentUser;

// TODO(you): prompt the user to re-provide their sign-in credentials
const credential = promptForCredentials();

user.reauthenticateWithCredential(credential).then(() => {
  // User re-authenticated.
}).catch((error) => {
  // An error occurred
  // ...
});
manage.js

导入用户帐号

您可以使用 Firebase CLI 的 auth:import 命令，将用户帐号从文件导入 Firebase 项目中。例如：

firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14