以下是 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 服务器的响应（包含详细信息）。如果错误持续存在，请向我们的 Bug 报告支持渠道报告该问题。 |
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 |
没有与所提供的标识符相对应的现有用户记录。 |