UUID 생성기

UUID란?

UUID(Universally Unique Identifier)는 128비트 길이의 고유 식별자로, RFC 4122에 의해 표준화되었습니다. 일반적으로 8-4-4-4-12 형식의 16진수 문자열(예: 550e8400-e29b-41d4-a716-446655440000)로 표현되며, 하이픈을 제거하면 32자입니다. 데이터베이스 기본 키, API 요청 식별, 세션 관리, 파일명 생성 등 소프트웨어 개발 전반에서 사용됩니다.

이 도구는 UUID 버전 4(v4)를 생성합니다. v4는 122비트의 난수(random)로 생성되며, 나머지 6비트는 버전 정보(4)'와 RFC 변형 비트로 고정됩니다. 이론적으로 동일한 UUID가 생성될 확률은 극히 낮아(2^122 조합), 실무에서 충돌 걸정 없이 사용할 수 있습니다.

모든 생성은 브라우저의 Math.random()을 사용하여 클라이언트 측에서 수행되며, 서버로 데이터가 전송되지 않습니다.

UUID 버전 비교

UUID는 여러 버전이 존재하며, 각각 다른 생성 방식과 특성을 가집니다.

UUID v1은 타임스탬프와 MAC 주소를 기반으로 생성됩니다. 시간 순서가 보장되지만, MAC 주소가 노출되어 프라이버시 우려가 있습니다.

UUID v4는 완전한 난수 기반입니다. 생성이 간단하고 개인정보를 포함하지 않아 가장 널리 사용됩니다. 단, 시간 순서가 없어 데이터베이스 인덱스 성능에 영향을 줄 수 있습니다.

UUID v7은 2024년 RFC 9562로 표준화된 최신 버전입니다. 상위 48비트에 Unix 타임스탬프(밀리초)를 포함하여 시간 순으로 정렬되며, B-tree 인덱스 성능이 우수합니다. 새로운 프로젝트에서는 v7 채택을 검토할 가치가 있습니다.

실무 활용 사례

분산 시스템 기본 키(PK) — 여러 서비스에서 동시에 레코드를 생성할 때, 중앙 서버 없이 충돌 없는 ID를 확보할 수 있습니다. Auto-increment ID와 달리 노드 간 조율이 필요 없습니다.

세션 및 추적 키 — 비로그인 사용자의 장바구니, 임시 세션, 파일 업로드 식별자를 빠르게 발급할 수 있습니다.

테스트 데이터 생성 — QA 환경에서 더미 레코드에 일관된 고유 키를 부여하여 테스트 데이터 충돌을 방지합니다.

API 멱등 키(Idempotency Key) — 결제 API 등 중복 요청을 방지해야 하는 경우, 요청별 고유 UUID를 헤더에 포함하여 멱등성을 보장합니다.

저장 및 사용 시 주의사항

대소문자 통일 — UUID는 대소문자를 구분하지 않지만(RFC 4122), 데이터베이스나 API에서 문자열 비교 시 불일치가 발생할 수 있습니다. 프로젝트 전체에서 소문자 또는 대문자로 통일하세요.

하이픈 포함/제거 통일 — 하이픈 포함 시 36자, 제거 시 32자입니다. 길이 검증 로직이 다를 수 있으므로, 시스템 전체에서 하나의 형식을 선택해 일관적으로 적용하세요.

보안 토큰으로 사용 금지 — UUID는 식별자이지 비밀 키가 아닙니다. 인증 토큰, 세션 시크릿 등 보안이 필요한 값에는 crypto.getRandomValues()나 전용 토큰 라이브러리를 사용하세요.

데이터베이스 성능 — UUID v4는 난수 기반이므로 B-tree 인덱스에서 페이지 분할(page split)이 빈번하게 발생할 수 있습니다. 대량 INSERT가 필요한 환경에서는 UUID v7이나 ULID처럼 시간 순서가 있는 포맷을 검토하세요.

결과 해석 가이드

UUID v4의 구조는 xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx입니다. 여기서 4는 UUID 버전을, y 위치의 첫 글자(8, 9, a, b 중 하나)는 RFC 4122 변형 비트를 나타냅니다. 이 두 위치를 확인하면 생성된 UUID가 유효한 v4 형식인지 검증할 수 있습니다.

자주 묻는 질문