DEV WIKI
보안 · 오류·증상

auth/phone-number-already-exists

저자
Woody
최종 검토
2026-07-24
참고 자료
있음
관련 기술

빠른 답변

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

현재 증상

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

먼저 확인할 항목

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

오류 코드가 일치하면 제공한 `phoneNumber`가 기존 사용자에게 이미 사용 중인 경우로 판정합니다.

환경별 원인과 조치

의미

auth/phone-number-already-exists는 제공한 phoneNumber가 기존 사용자가 이미 사용 중인 값임을 뜻합니다. Firebase Admin Node.js Authentication API에서는 각 사용자의 phoneNumber가 고유해야 합니다.

확인

  1. 현재 화면 또는 로그에 표시된 오류 코드가 정확히 auth/phone-number-already-exists인지 확인합니다.
  2. 일치하면 제공한 phoneNumber가 기존 사용자에게 이미 사용 중인 경우로 식별합니다.

이 절차는 오류 코드 문자열과 공식 설명을 비교하는 읽기 전용 확인입니다.

출처

참고 자료

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

Firebase · 공식 자료 · 확인 범위: Firebase Admin Node.js Authentication API는 auth/phone-number-already-exists 오류 코드를 제공합니다., 이 오류는 제공한 phoneNumber가 기존 사용자가 이미 사용 중인 경우를 뜻합니다., 각 사용자의 phoneNumber는 고유해야 합니다. · 확인일: 2026-07-24