Admin Authentication API 错误

以下是 Firebase Admin Node.js Authentication API 给出的错误代码的完整列表(包括说明和推荐的解决步骤):

错误代码 说明和解决步骤
auth/claims-too-large 提供给 setCustomUserClaims() 的声明载荷超过了允许的大小上限(1000 字节)。
auth/email-already-exists 提供的电子邮件地址已被现有用户使用。每个用户的电子邮件地址都必须是唯一的。
auth/id-token-expired 提供的 Firebase ID 令牌已过期。
auth/id-token-revoked Firebase ID 令牌已被撤消。
auth/insufficient-permission 用于初始化 Admin SDK 的凭据没有足够的权限来访问所请求的 Authentication 资源。如需查看有关如何生成具有相应权限的凭据并使用该凭据对 Admin SDK 进行身份验证的文档,请参阅设置 Firebase 项目
auth/internal-error Authentication 服务器在尝试处理请求时遇到意外错误。错误消息应包含来自 Authentication 服务器的响应(包含额外的信息)。如果错误持续存在,请向我们的错误报告支持渠道报告该问题。
auth/invalid-argument 向 Authentication 方法提供的参数无效。错误消息应包含其他信息。
auth/invalid-claims 提供给 setCustomUserClaims() 的自定义声明特性无效。
auth/invalid-continue-uri 接续网址必须是有效的网址字符串。
auth/invalid-creation-time 创建时间必须是有效的世界协调时间 (UTC) 日期字符串。
auth/invalid-credential 用来对 Admin SDK 进行身份验证的凭据无法用于执行所需的操作。某些 Authentication 方法(如 createCustomToken()verifyIdToken())要求使用证书凭据(而不是刷新令牌或应用默认凭据)初始化 SDK。如需了解如何使用证书凭据对 Admin SDK 进行身份验证,请参阅初始化 SDK
auth/invalid-disabled-field 提供的 disabled 用户属性值无效。此值必须是一个布尔值。
auth/invalid-display-name 提供的 displayName 用户属性值无效。此值必须是非空字符串。
auth/invalid-dynamic-link-domain 提供的动态链接网域没有针对当前项目配置或授权。
auth/invalid-email 提供的 email 用户属性值无效。此值必须是一个字符串电子邮件地址。
auth/invalid-email-verified 提供的 emailVerified 用户属性值无效。此值必须是一个布尔值。
auth/invalid-hash-algorithm 哈希算法必须与受支持算法列表中的某个字符串匹配。
auth/invalid-hash-block-size 哈希块大小必须为有效数字。
auth/invalid-hash-derived-key-length 哈希派生密钥长度必须为有效数字。
auth/invalid-hash-key 哈希密钥必须为有效的字节缓冲区。
auth/invalid-hash-memory-cost 哈希内存开销必须为有效数字。
auth/invalid-hash-parallelization 哈希并行度必须为有效数字。
auth/invalid-hash-rounds 哈希轮数必须为有效数字。
auth/invalid-hash-salt-separator 哈希算法加盐分隔符字段必须是有效的字节缓冲区。
auth/invalid-id-token 提供的 ID 令牌不是有效的 Firebase ID 令牌。
auth/invalid-last-sign-in-time 上次登录时间必须是有效的世界协调时间 (UTC) 日期字符串。
auth/invalid-page-token listUsers() 中提供的下一页令牌无效。此值必须是非空字符串。
auth/invalid-password 提供的 password 用户属性值无效。此值必须是一个至少包含六个字符的字符串。
auth/invalid-password-hash 密码哈希必须是有效的字节缓冲区。
auth/invalid-password-salt 密码加密盐必须是有效的字节缓冲区
auth/invalid-phone-number 提供的 phoneNumber 值无效。此值必须是一个符合 E.164 标准的非空标识符字符串。
auth/invalid-photo-url 提供的 photoURL 用户属性值无效。此值必须是一个字符串网址。
auth/invalid-provider-data providerData 必须是有效的 UserInfo 对象数组。
auth/invalid-provider-id providerId 必须是有效的受支持提供方标识符字符串。
auth/invalid-oauth-responsetype 只应将一个 OAuth responseType 设为 true。
auth/invalid-session-cookie-duration 会话 Cookie 时长必须是介于 5 分钟到 2 周之间的有效数字(以毫秒为单位)。
auth/invalid-uid 提供的 uid 必须是一个最多包含 128 个字符的非空字符串。
auth/invalid-user-import 要导入的用户记录无效。
auth/maximum-user-count-exceeded 已超出允许导入的用户数上限。
auth/missing-android-pkg-name 如果需要安装 Android 应用,则必须提供 Android 软件包名称。
auth/missing-continue-uri 必须在请求中提供有效的接续网址。
auth/missing-hash-algorithm 要使用密码哈希导入用户,必须提供哈希算法及其参数。
auth/missing-ios-bundle-id 请求中缺少软件包 ID。
auth/missing-uid 需要为当前操作提供 uid 标识符。
auth/missing-oauth-client-secret 如需启用 OIDC 代码流程,必须提供 OAuth 配置客户端密钥。
auth/operation-not-allowed 您的 Firebase 项目已停用所提供的登录提供方。 请在 Firebase 控制台的登录方法部分中将其启用。
auth/phone-number-already-exists 提供的 phoneNumber 已被现有用户使用。每个用户的 phoneNumber 都必须是唯一的。
auth/project-not-found 没有找到用于初始化 Admin SDK 的凭据所对应的 Firebase 项目。如需了解如何为您的项目生成凭据并使用该凭据对 Admin SDK 进行身份验证,请参阅设置 Firebase 项目
auth/reserved-claims 提供给 setCustomUserClaims() 的一个或多个自定义用户声明是系统预留内容。例如,OIDC 专用的声明(例如 sub、iat、iss、exp、aud、auth_time 等)不应用作自定义声明的键。
auth/session-cookie-expired 提供的 Firebase 会话 Cookie 已过期。
auth/session-cookie-revoked Firebase 会话 Cookie 已被撤消。
auth/too-many-requests 请求数量超过允许的上限。
auth/uid-already-exists 提供的 uid 已被现有用户使用。每个用户的 uid 都必须是唯一的。
auth/unauthorized-continue-uri 接续网址的网域未列入白名单。请在 Firebase 控制台中将该网域列入白名单。
auth/user-not-found 没有与所提供的标识符相对应的现有用户记录。