Admin Authentication API Errors

以下是 Firebase 管理 Node.js 身份驗證 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 的憑證沒有足夠的權限來存取請求的身份驗證資源。請參閱設定 Firebase 項目,以取得有關如何產生具有適當權限的憑證並使用它來驗證管理 SDK 的文件。
auth/internal-error身份驗證伺服器在嘗試處理請求時遇到意外錯誤。錯誤訊息應包含來自身份驗證伺服器的回應,其中包含附加資訊。如果錯誤仍然存在,請將問題報告給我們的錯誤報告支援管道。
auth/invalid-argument向身份驗證方法提供的參數無效。錯誤訊息應包含附加資訊。
auth/invalid-claims提供給setCustomUserClaims()自訂聲明屬性無效。
auth/invalid-continue-uri繼續 URL 必須是有效的 URL 字串。
auth/invalid-creation-time建立時間必須是有效的 UTC 日期字串。
auth/invalid-credential用於驗證管理 SDK 的憑證不能用於執行所需的操作。某些驗證方法(例如createCustomToken()verifyIdToken()要求使用憑證憑證(而不是刷新令牌或應用程式預設憑證)來初始化 SDK。有關如何使用憑證憑證對管理 SDK 進行驗證的文檔,請參閱初始化 SDK
auth/invalid-disabled-fielddisabled使用者屬性提供的值無效。它必須是一個布林值。
auth/invalid-display-namedisplayName使用者屬性提供的值無效。它必須是一個非空字串。
auth/invalid-dynamic-link-domain目前項目未配置或授權提供的動態連結網域。
auth/invalid-emailemail使用者屬性提供的值無效。它必須是字串電子郵件地址。
auth/invalid-email-verifiedemailVerified用戶屬性提供的值無效。它必須是一個布林值。
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-passwordpassword使用者屬性提供的值無效。它必須是至少包含六個字元的字串。
auth/invalid-password-hash密碼哈希必須是有效的位元組緩衝區。
auth/invalid-password-salt密碼鹽必須是有效的位元組緩衝區
auth/invalid-phone-number提供的phoneNumber值無效。它必須是一個非空的符合 E.164 標準的識別符字串。
auth/invalid-photo-urlphotoURL使用者屬性提供的值無效。它必須是字串 URL。
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請求中必須提供有效的繼續 URL。
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未找到用於初始化管理 SDK 的憑證的 Firebase 專案。請參閱設定 Firebase 項目,以取得有關如何為項目產生憑證並使用它來驗證管理 SDK 的文件。
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繼續 URL 的網域未列入白名單。在 Firebase 控制台中將網域列入白名單。
auth/user-not-found沒有與所提供的標識符對應的現有使用者記錄。