以下是 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 的憑證權限不足，無法存取要求的驗證資源。請參閱「設定 Firebase 專案」說明文件，瞭解如何產生具有適當權限的憑證，並用來驗證 Admin SDK。 |
auth/internal-error |
驗證伺服器在嘗試處理要求時發生未預期的錯誤，錯誤訊息應包含驗證伺服器的回應，其中包含額外資訊。如果錯誤持續發生，請透過錯誤報告支援管道回報問題。 |
auth/invalid-argument |
提供給驗證方式的引數無效。錯誤訊息中應包含其他資訊。 |
auth/invalid-claims |
提供給 setCustomUserClaims() 的自訂聲明屬性無效。 |
auth/invalid-continue-uri
|
繼續網址必須是有效的網址字串。 |
auth/invalid-creation-time
|
建立時間必須是有效的世界標準時間 (UTC) 日期字串。 |
auth/invalid-credential |
用於驗證 Admin SDK 的憑證無法用於執行所需動作。某些驗證方法 (例如 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 標準標準 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 |
必須提供 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 沒有對應的現有使用者記錄。 |