auth/claims-too-large
빠른 답변
- 이 오류는 무엇인가요?
- Firebase Admin Node.js Authentication API에서 `setCustomUserClaims()`의 클레임 페이로드가 1,000바이트를 초과했을 때의 오류 코드입니다.
- 가장 흔한 원인은 무엇인가요?
- `auth/claims-too-large`는 `setCustomUserClaims()`에 제공한 클레임 페이로드가 최대 허용 크기인 1,000바이트를 초과했음을 뜻합니다.
- 무엇을 먼저 확인해야 하나요?
- 현재 화면 또는 로그의 오류 코드가 `auth/claims-too-large`와 정확히 일치하는지 확인합니다.
현재 증상
- 애플리케이션 오류 메시지
먼저 확인할 항목
현재 화면 또는 로그의 오류 코드가 `auth/claims-too-large`와 정확히 일치하는지 확인합니다.
오류 코드가 일치하면 원문 설명과 대조해 `setCustomUserClaims()`에 제공된 클레임 페이로드가 1,000바이트를 초과한 상태로 판정합니다.
환경별 원인과 조치
확인
현재 화면 또는 로그에 표시된 오류 코드가 auth/claims-too-large와 일치하는지 확인합니다.
일치하면 Firebase 공식 문서 기준으로 setCustomUserClaims()에 제공한 클레임 페이로드가 최대 허용 크기인 1,000바이트를 초과한 상태입니다.
출처
참고 자료
Admin Authentication API Errors | Firebase Authentication (새 창에서 열림)
Firebase · 공식 자료 · 확인 범위: Firebase Admin Node.js Authentication API의 오류 코드로 `auth/claims-too-large`가 제공됩니다., 이 오류 코드는 `setCustomUserClaims()`에 제공된 클레임 페이로드가 최대 허용 크기인 1,000바이트를 초과한 경우를 뜻합니다. · 확인일: 2026-07-24