以下是 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
|
建立時間必須是有效的世界標準時間日期字串。 |
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
|
上次登入時間必須是有效的世界標準時間日期字串。 |
auth/invalid-page-token |
listUsers() 中提供的下一頁權杖無效。必須是有效的非空白字串。 |
auth/invalid-password |
你提供的 password 使用者屬性值無效。該屬性值必須為至少含有六個字元的字串。 |
auth/invalid-password-hash
|
密碼雜湊必須是有效的位元組緩衝區。 |
auth/invalid-password-salt
|
密碼鹽必須是有效的位元組緩衝區 |
auth/invalid-phone-number |
您提供的 phoneNumber 值無效。必須是符合 E.164 標準的非空白 ID 字串。 |
auth/invalid-photo-url |
你提供的 photoURL 使用者屬性值無效。必須是字串網址。
|
auth/invalid-provider-data
|
providerData 必須是有效的 UserInfo 物件陣列。 |
auth/invalid-provider-id
|
providerId 必須是有效的支援供應器 ID 字串。 |
auth/invalid-oauth-responsetype
|
只有一個 OAuth responseType 應設為「是」。 |
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 ID。 |
auth/missing-oauth-client-secret |
您必須提供 OAuth 設定用戶端密鑰，才能啟用 OIDC 代碼流程。 |
auth/operation-not-allowed |
您提供的登入服務供應商已為您的 Firebase 專案停用。 您可以前往 Firebase 控制台的「 登入方法」部分啟用這項功能。 |
auth/phone-number-already-exists |
已有另一位現有使用者在使用你所提供的 phoneNumber。每位使用者都必須有不重複的 phoneNumber。 |
auth/project-not-found |
系統找不到用來初始化 Admin SDK 的憑證所屬的 Firebase 專案。請參閱「設定 Firebase 專案」中的說明文件，瞭解如何為專案產生憑證，並用於驗證 Admin 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 |
繼續網址的網域未列入許可清單。在 Firebase 控制台中將網域加入白名單。 |
auth/user-not-found |
沒有與提供的 ID 相符的現有使用者記錄。 |