管理 Firebase 中的用户

创建用户

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

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

获取当前登录的用户

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

Web

详细了解可实现摇树优化的模块化 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

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

详细了解可实现摇树优化的模块化 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

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

详细了解可实现摇树优化的模块化 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

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

详细了解可实现摇树优化的模块化 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

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

详细了解可实现摇树优化的模块化 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

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

详细了解可实现摇树优化的模块化 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

const user = firebase.auth().currentUser;

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

重要提示：如需设置用户的电子邮件地址，该用户必须最近登录过。 请参阅重新对用户进行身份验证。

向用户发送验证电子邮件

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

Web

详细了解可实现摇树优化的模块化 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

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

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

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

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

Web

详细了解可实现摇树优化的模块化 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

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

设置用户密码

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

Web

详细了解可实现摇树优化的模块化 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

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

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

重要提示：如需设置用户的密码，该用户必须最近登录过。请参阅重新对用户进行身份验证。

发送重设密码电子邮件

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

Web

详细了解可实现摇树优化的模块化 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

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

详细了解可实现摇树优化的模块化 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

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

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

删除用户

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

Web

详细了解可实现摇树优化的模块化 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

const user = firebase.auth().currentUser;

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

重要提示：如需删除用户，该用户必须最近登录过。请参阅重新对用户进行身份验证。

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

重新对用户进行身份验证

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

Web

详细了解可实现摇树优化的模块化 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

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