이 글에서 소개한 도구
글을 읽으면서 브라우저에서 바로 도구를 열어 작업 흐름을 직접 확인해 보세요.
UUID란?
UUID(Universally Unique Identifier, 범용 고유 식별자) 는 컴퓨터 시스템에서 정보를 식별하는 데 쓰는 128비트 레이블입니다. RFC 4122로 표준화되었고(2024년 RFC 9562로 갱신), UUID는 보통 다음과 같은 표준 형식으로 씁니다.

550e8400-e29b-41d4-a716-446655440000
16진수 8자 다음에 4자, 4자, 4자, 12자 그룹이 이어집니다. 항상 16진수 32자에 하이픈 4개를 더해 모두 36자입니다.
UUID의 근본적인 약속은, 어떤 기계에서 언제 생성하더라도 지금까지 생성된 다른 어떤 UUID와도 충돌할 확률이 천문학적으로 낮다는 것입니다. 그래서 중앙 ID 관리 기관과 조율할 수 없는 분산 시스템에서 매우 소중합니다.
버전 전체 레퍼런스
UUID 사양은 여러 버전을 정의하며 각각 생성 방식이 다릅니다.
| 버전 | 생성 방식 | 정렬 가능 | 쓰는 때 |
|---|---|---|---|
| v1 | MAC 주소 + 타임스탬프 | 부분적 | 레거시 시스템, 감사 추적 |
| v2 | DCE 보안(POSIX UID/GID) | 아니요 | 거의 쓰지 않음 |
| v3 | 네임스페이스 + 이름의 MD5 해시 | 아니요 | 알려진 입력으로 결정적 ID를 만들 때(레거시) |
| v4 | 무작위 | 아니요 | 범용, 세션 ID |
| v5 | 네임스페이스 + 이름의 SHA-1 해시 | 아니요 | 알려진 입력으로 결정적 ID를 만들 때 |
| v6 | 타임스탬프 + 무작위(재배열한 v1) | 예 | 정렬 가능한 v1의 대체 |
| v7 | Unix 밀리초 타임스탬프 + 무작위 | 예 | 데이터베이스 기본 키(권장) |
| v8 | 사용자 정의 레이아웃 | 다양함 | 애플리케이션 전용 형식 |
버전 1: MAC 주소 + 타임스탬프
UUID v1은 생성한 기계의 MAC 주소와 100나노초 단위 타임스탬프를 인코딩합니다. 기계의 정체성과 시간의 조합이 고유하므로 충돌 위험이 극히 낮습니다.
단점: MAC 주소는 개인을 식별할 수 있는 정보입니다. 웹 애플리케이션에서 v1 UUID를 생성하면 서버 하드웨어의 세부 정보가 의도치 않게 드러날 수 있습니다. 이 때문에 새 시스템에서는 v1이 대체로 외면받고 있습니다.
버전 3과 버전 5: 결정적 UUID
v3와 v5 모두 네임스페이스 UUID와 이름 문자열에서 해시 함수(v3는 MD5, v5는 SHA-1)로 UUID를 만듭니다. 입력이 같으면 항상 같은 UUID가 나옵니다.
외부 데이터에서 안정적인 식별자를 만들 때 유용합니다.
// v5 예: 같은 URL은 항상 같은 UUID를 만듭니다
// URL용 네임스페이스 UUID는 RFC 4122에 정의되어 있습니다
const DNS_NAMESPACE = '6ba7b810-9dad-11d1-80b4-00c04fd430c8';
uuidv5('example.com', DNS_NAMESPACE); // 항상 같은 결과
가능하면 v3보다 v5를 쓰세요. SHA-1이 MD5보다 강력하지만, 새 설계에서는 어느 쪽도 암호학적 용도에 적합하지 않습니다.
버전 4: 가장 많이 쓰이는 일꾼
UUID v4는 단순히 암호학적으로 안전한 무작위 데이터 122비트입니다(나머지 6비트는 버전과 변형을 인코딩). 세상에서 가장 많이 생성되는 UUID 종류입니다.
// 브라우저 / Node.js (내장, 라이브러리 불필요)
const id = crypto.randomUUID(); // "f47ac10b-58cc-4372-a567-0e02b2c3d479"
// Python
import uuid
print(uuid.uuid4()) # 3d6f4890-4f40-4d09-aa11-3efb...
// Go
import "github.com/google/uuid"
id := uuid.New()
충돌 확률: 초당 10억 개의 v4 UUID를 86년 동안 생성하면 한 번이라도 충돌할 확률이 약 50%입니다. 실용적으로는 충돌이 사실상 불가능합니다.
한계: v4 UUID는 무작위이므로 정렬할 수 없습니다. 무작위 UUID를 기본 키로 B-tree 인덱스에 넣으면 시간이 지나며 인덱스 단편화가 생겨 대규모에서 쓰기 성능이 나빠집니다.
버전 7: 현대의 표준
UUID v7은 RFC 9562(2024년 5월)로 표준화되었습니다. 가장 상위 비트에 Unix 밀리초 타임스탬프를 두고 그 뒤에 무작위 데이터를 둡니다.
0 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| unix_ts_ms |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| unix_ts_ms | ver | rand_a |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|var| rand_b |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| rand_b |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
타임스탬프가 상위 비트에 있으므로 v7 UUID는 생성 시각 순으로 사전순 정렬이 가능합니다. 연이어 생성한 두 UUID는 그 순서대로 정렬되며, 데이터베이스 인덱스가 바라는 바로 그것입니다.
// 'uuidv7' 패키지 사용
import { uuidv7 } from 'uuidv7';
const id1 = uuidv7(); // "018e1f27-42a0-7000-8000-..."
const id2 = uuidv7(); // "018e1f27-42a1-7000-..."
// id1 < id2 (문자열 비교로도 올바른 순서가 나옴)
UUID와 순차 정수 ID
데이터베이스 기본 키로는 전통적으로 자동 증가 정수(SERIAL, AUTO_INCREMENT)를 썼습니다. UUID는 그 트레이드오프를 바꿉니다.
| 관점 | 자동 증가 정수 | UUID v4 | UUID v7 |
|---|---|---|---|
| ID 예측 가능성 | 추측 가능(열거 가능) | 예측 불가 | 예측 불가 |
| 인덱스 성능 | 우수(순차) | 나쁨(무작위 쓰기) | 우수(시간순) |
| 분산 생성 | 중앙 조정자가 필요 | 어느 노드든 언제든 | 어느 노드든 언제든 |
| 병합 / 복제 | 복잡 | 간단 | 간단 |
| 행당 크기 오버헤드 | 4~8바이트 | 16바이트 | 16바이트 |
| 사람이 읽기 쉬운가 | 쉬움 | 어려움 | 어려움 |
대부분의 최신 시스템, 특히 마이크로서비스를 운영하거나 다중 리전 배포를 하거나 여러 출처의 데이터를 병합하는 시스템에서는 UUID v7이 기본 키의 알맞은 기본값입니다.
주요 언어에서 UUID 생성하기
JavaScript / TypeScript
// v4 — 최신 브라우저와 Node.js 14.17+에 내장
const sessionId = crypto.randomUUID();
// v7 — uuidv7 패키지 설치
import { uuidv7 } from 'uuidv7';
const recordId = uuidv7();
Python
import uuid
# v4
print(uuid.uuid4())
# v7 — Python 3.12+에서 서드파티 라이브러리로 사용 가능
# pip install uuid7
from uuid7 import uuid7
print(uuid7())
Go
import "github.com/google/uuid"
// v4
id := uuid.New()
// v7
id, err := uuid.NewV7()
PostgreSQL
-- v4 내장(pgcrypto 또는 pg 13+ 필요)
SELECT gen_random_uuid();
-- pgx 또는 애플리케이션 측 생성으로 v7 사용
INSERT INTO users (id, email) VALUES ($1, $2)
-- 애플리케이션 계층에서 uuidv7()을 전달
실무에서 고려할 점
데이터베이스에 UUID 저장하기
- PostgreSQL: 네이티브
UUID타입을 쓰세요. 36자 문자열이 아니라 16바이트로 저장됩니다. - MySQL/MariaDB: 효율을 위해
BINARY(16), 가독성을 위해CHAR(36)을 쓰세요. 정렬 가능성을 보존하려면UUID_TO_BIN(uuid, true)로 삽입합니다. - SQLite:
BLOB(16)또는TEXT(36)으로 저장합니다.
문자열 저장과 바이너리 저장
텍스트 문자열("f47ac10b-58cc-4372-a567-0e02b2c3d479")로 둔 UUID는 36바이트를 차지합니다. 원시 바이너리로는 16바이트입니다. 수백만 행에서는 이 차이가 저장 공간과 인덱스 크기 모두에서 의미가 있습니다.
URL에 안전한 UUID
표준 UUID는 16진수와 하이픈만 있으므로 URL에 안전합니다. 다만 URL에 쓸 더 간결한 표현을 원한다면 하이픈을 제거하거나(32자) Base64Url 인코딩(22자)을 쓸 수 있습니다.
2026년 11월에 추가된 기능
- NanoID(문자와 길이 지정, 편향 없음, 충돌 확률 목안 포함), KSUID(시각 읽기 포함), 시간 기반 UUID v1 / v6를 생성할 수 있습니다.
- v1 / v6의 노드는 난수(멀티캐스트 비트 포함)이며 MAC 주소는 쓰지 않습니다. v6는 문자열 그대로 시간순으로 정렬되어 데이터베이스 기본 키에 적합합니다.
자주 묻는 질문
UUID v4는 진정한 무작위인가요?
UUID v4는 122비트의 무작위 데이터를 씁니다(나머지 6비트는 버전과 변형으로 고정). “진정한” 무작위인지는 난수 생성기에 달려 있습니다. 최신 환경은 대부분 암호학적으로 안전한 의사 난수 생성기(CSPRNG)를 사용하며 보안이 중요한 용도에도 적합합니다. 브라우저와 Node.js의 crypto.randomUUID()는 시스템 CSPRNG를 사용합니다.
기존 v4 UUID를 전부 v7로 바꿔야 하나요?
아니요. 기존 ID를 이전하는 것은 대개 수고만큼의 가치가 없습니다. v7의 장점(정렬 가능성, 인덱스 지역성)은 새로 삽입하는 행에 적용됩니다. 이미 v4 UUID를 쓰고 있고 인덱스 성능이 괜찮다면 그대로 두세요. 새 테이블이나 새 시스템부터 v7을 쓰기 시작하면 됩니다.
두 기계가 같은 UUID v4를 만들 수 있나요?
이론적으로는 가능하지만 실제로는 아닙니다. 122비트의 무작위성이면 충돌 확률이 50%에 이르려면 약 2.7 × 10¹⁸개의 UUID를 생성해야 합니다. 전 세계 모든 기계에서 초당 10억 개를 생성한다고 해도 85년이 넘게 걸립니다.
nil UUID란 무엇인가요?
nil UUID는 모두 0입니다: 00000000-0000-0000-0000-000000000000. null과 비슷하게 “UUID 없음”을 나타내는 센티널 값으로 쓰입니다. 일부 ORM은 ID가 부여되기 전의 기본값으로 사용합니다.
UUID 형식을 검증하려면 어떻게 하나요?
간단한 정규표현식 검사:
const UUID_REGEX =
/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
UUID_REGEX.test('550e8400-e29b-41d4-a716-446655440000'); // true
UUID_REGEX.test('not-a-uuid'); // false
버전별 검증을 하려면 14번째 위치(버전 숫자)가 기대하는 버전 번호와 일치하는지 확인하세요.
