DEV WIKI
보안 · 오류·증상

auth/uid-already-exists

최종 검토
2026-07-27
수정일
2026-07-27
참고 자료
있음
관련 기술

빠른 답변

이 오류는 무엇인가요?
Firebase Admin Node.js Authentication API에서 이미 사용 중인 uid를 제공했을 때 발생하는 오류 코드입니다.
가장 흔한 원인은 무엇인가요?
현재 화면 또는 로그의 오류 코드가 `auth/uid-already-exists`와 일치하면, 제공한 uid가 기존 사용자가 이미 사용 중인 uid이며 각 사용자는 고유한 uid를 가져야 한다는 뜻입니다.
무엇을 먼저 확인해야 하나요?
현재 화면 또는 로그의 오류 코드가 `auth/uid-already-exists`와 정확히 일치하는지 확인합니다.

현재 증상

  • 애플리케이션 오류 메시지

먼저 확인할 항목

현재 화면 또는 로그의 오류 코드가 `auth/uid-already-exists`와 정확히 일치하는지 확인합니다.

일치할 경우 공식 설명과 대조해 제공한 uid가 기존 사용자가 이미 사용 중인 상태인지 확인합니다.

환경별 원인과 조치

확인

현재 화면 또는 로그에 표시된 오류 코드가 auth/uid-already-exists인지 확인합니다.

  • 일치하면 제공한 uid가 기존 사용자가 이미 사용 중인 상태입니다.
  • Firebase는 각 사용자가 고유한 uid를 가져야 한다고 설명합니다.

이 문서는 오류 코드 식별만 다룹니다.

진단 기록

먼저 문제가 발생한 URL 또는 화면, 표시 시각, 사용한 플랫폼과 배포 버전을 기록합니다. 화면과 로그에서 오류 문자열이 일부만 보이면 앞뒤 문장을 포함해 원문을 보존하고, 민감한 값은 가립니다.

다음 순서로 관찰값을 대조합니다.

  1. 현재 화면 또는 로그의 오류 코드가 auth/uid-already-exists와 정확히 일치하는지 확인합니다.
  2. 일치할 경우 공식 설명과 대조해 제공한 uid가 기존 사용자가 이미 사용 중인 상태인지 확인합니다.

각 항목은 확인한 값과 확인하지 못한 이유를 함께 기록해야 합니다. 이 문서의 조건과 실제 관찰값이 다르면 원인을 단정하지 말고, 문제 해결 시작 가이드에서 더 넓은 분기를 선택하십시오.

판정 기준

오류 문자열이 일치한다는 사실만으로 원인이 확정되지는 않습니다. 같은 문구가 여러 환경에서 나타날 수 있으므로 웹서버·런타임·운영체제·최근 변경 사항을 함께 비교합니다. 한 단계에서 기대한 값이 나오지 않으면 다음 단계로 넘어가지 말고 해당 환경의 공식 문서를 우선 확인합니다.

안전한 다음 단계

검사 전에 백업과 변경 이력을 확인하고, 비밀번호·세션 쿠키·인증 토큰·개인정보를 공개 로그나 문의 내용에 넣지 않습니다. 설정·권한·데이터를 변경해야 한다면 영향 범위와 되돌리는 방법을 먼저 기록한 뒤 운영 시간과 승인 절차에 맞춰 진행합니다.

참고 자료

Admin Authentication API Errors | Firebase Authentication (새 창에서 열림)

Firebase · 공식 자료 · 확인 범위: Firebase Admin Node.js Authentication API는 `auth/uid-already-exists` 오류 코드를 제공합니다., 이 오류는 제공한 uid가 기존 사용자가 이미 사용 중임을 뜻합니다., 각 사용자는 고유한 uid를 가져야 합니다. · 확인일: 2026-07-27