以下是 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 設為 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 ID。
|
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 |
沒有與所提供 ID 相符的現有使用者記錄。 |