UUID 버전 설명

v1부터 v8까지의 모든 UUID 버전 — 구조 다이어그램, 사용 사례, 충돌 위험 및 JavaScript 코드 예시 포함.

UUID 구조

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

time_low (32 bits)time_mid (16 bits)M = version (4 bits) + time_hi (12)N = variant (2 bits) + clock (14)node / random (48 bits)

UUID v1Time-based (MAC)Sortable

구조

timestamp (60-bit) + clock seq (14-bit) + MAC (48-bit)

충돌 위험

Very low

6ba7b810-9dad-11d1-80b4-00c04fd430c8

장점

+Globally unique
+Sortable by time
+Embeds creation time

단점

−Exposes MAC address (privacy risk)
−Requires MAC or pseudo-random node
−Clock adjustments can cause duplicates

최적 용도

Legacy systems. Avoid in new projects due to MAC address exposure.

UUID v3Name-based (MD5)Not sortable

구조

MD5(namespace UUID + name) → UUID

충돌 위험

MD5 collision risk (low for UUIDs)

6fa459ea-ee8a-3ca4-894e-db77e160355e

장점

+Deterministic — same input = same UUID
+Can recreate UUIDs from known inputs

단점

−MD5 is cryptographically weak
−Not random — attackers can predict given namespace+name
−Prefer v5 for new projects

최적 용도

Generating UUIDs from URLs, email addresses, or other stable identifiers. Use v5 instead.

UUID v4RandomNot sortable

구조

122 random bits + 4-bit version + 2-bit variant

충돌 위험

Negligible (2^122 possibilities)

550e8400-e29b-41d4-a716-446655440000

장점

+Extremely low collision probability
+No timestamp/MAC leakage
+Simple generation — no state needed
+Most widely supported

단점

−Not sortable by generation time
−Random order degrades B-tree performance in databases
−Cannot verify when a UUID was created

최적 용도

Default choice for most applications. IDs for records, sessions, tokens.

UUID v5Name-based (SHA-1)Not sortable

구조

SHA-1(namespace UUID + name) → UUID (top 128 bits)

충돌 위험

SHA-1 — extremely low for UUID purposes

886313e1-3b8a-5372-9b90-0c9aee199e5d

장점

+Deterministic like v3, but uses SHA-1
+Stronger hash than MD5 (v3)
+Standard namespaces: DNS, URL, OID, X.500

단점

−SHA-1 is fully deterministic — not suitable for secrets
−Truncates SHA-1 to 128 bits

최적 용도

Deterministic IDs from a namespace + name. Example: UUID for 'https://example.com' is always the same.

UUID v7Time-ordered RandomSortable

구조

Unix ms timestamp (48-bit) + version (4-bit) + random (74-bit)

충돌 위험

Very low (74 random bits)

018f0b2d-4c9e-7abc-89de-f012345678ab

장점

+Sortable by time (great for database primary keys)
+Does NOT expose MAC address
+Near-zero collision probability
+RFC 9562 standard

단점

−Slightly less entropy than v4 (74 vs 122 bits)
−Requires a time source
−Newer — less library support than v4

최적 용도

Database primary keys where sort order matters. Replaces v1 for time-ordered UUIDs.

UUID v8CustomSortable

구조

128 bits, content defined by the implementation

충돌 위험

Depends on implementation

2489e9ad-f195-8b67-72da-3291d8c9fc1b

장점

+Fully customizable
+Useful for embedding application-specific data

단점

−No standard semantics — interoperability must be documented
−Not widely supported

최적 용도

Experimental or vendor-specific use cases where v1–v7 don't fit.

빠른 비교

Version	Method	Sortable	Privacy-safe	Deterministic
v1	Time + MAC	✅	❌ (MAC leak)	❌
v3	MD5 hash	❌	✅	✅
v4	Random	❌	✅	❌
v5	SHA-1 hash	❌	✅	✅
v7	Time + Random	✅	✅	❌
v8	Custom	—	—	—

코드에서 UUID 생성

// JavaScript / Node.js (built-in, Node 15+)
import { randomUUID } from 'crypto';
const v4 = randomUUID();  // → "550e8400-e29b-41d4-a716-446655440000"

// Browser
const v4 = crypto.randomUUID();

// UUID v7 (npm: uuid package v10+)
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();  // → "018f0b2d-4c9e-7abc-89de-f012345678ab"

// Python
import uuid
v4 = str(uuid.uuid4())  # Random
v5 = str(uuid.uuid5(uuid.NAMESPACE_URL, 'https://example.com'))

# PostgreSQL
SELECT gen_random_uuid();        -- v4 (pg 13+)
SELECT uuid_generate_v4();       -- v4 (uuid-ossp extension)
SELECT gen_random_uuid()::text;  -- as text

UUID 버전 FAQ

UUID란 무엇인가요?

UUID(Universally Unique Identifier)는 RFC 4122에 표준화된 128비트 식별자입니다. 하이픈으로 구분된 8-4-4-4-12 16진수 문자로 형식화됩니다. 중앙 기관 없이 공간과 시간을 초월하여 고유하도록 설계되었습니다.

어떤 UUID 버전을 사용해야 하나요?

대부분의 일반적인 목적에는 v4를 사용하세요 — 무작위로 생성되며 충돌 확률이 매우 낮습니다. 데이터베이스 기본 키에 시간순 UUID가 필요한 경우 v7을 사용하세요. 네임스페이스+이름 쌍에서 결정론적 UUID가 필요한 경우 v5를 사용하세요.

UUID v4와 v7의 차이는 무엇인가요?

UUID v4는 순수하게 무작위(122 무작위 비트)입니다. UUID v7은 처음 48비트에 Unix 타임스탬프를 인코딩하고 그 뒤에 무작위 비트가 옵니다. 이로 인해 v7 UUID는 생성 시간별로 정렬 가능하여 데이터베이스의 B-tree 인덱스 성능이 크게 향상됩니다.

UUID v4 ID가 실제로 고유한가요?

실용적으로는 그렇습니다. UUID v4는 122개의 무작위 비트를 가지며 2^122 ≈ 5.3 × 10^36개의 가능한 값을 제공합니다. 50%의 충돌 확률을 가지려면 약 2.7 × 10^18개의 UUID를 생성해야 합니다.

Version

Method

Sortable

Privacy-safe

Deterministic

Time + MAC

✅

❌ (MAC leak)

❌

MD5 hash

❌

✅

Random

❌

✅

❌

SHA-1 hash

❌

✅

Time + Random

✅

❌

Custom

—

코드에서 UUID 생성

// JavaScript / Node.js (built-in, Node 15+)
import { randomUUID } from 'crypto';
const v4 = randomUUID();  // → "550e8400-e29b-41d4-a716-446655440000"

// Browser
const v4 = crypto.randomUUID();

// UUID v7 (npm: uuid package v10+)
import { v7 as uuidv7 } from 'uuid';
const v7 = uuidv7();  // → "018f0b2d-4c9e-7abc-89de-f012345678ab"

// Python
import uuid
v4 = str(uuid.uuid4())  # Random
v5 = str(uuid.uuid5(uuid.NAMESPACE_URL, 'https://example.com'))

# PostgreSQL
SELECT gen_random_uuid();        -- v4 (pg 13+)
SELECT uuid_generate_v4();       -- v4 (uuid-ossp extension)
SELECT gen_random_uuid()::text;  -- as text

UUID 버전 FAQ

UUID란 무엇인가요?

어떤 UUID 버전을 사용해야 하나요?

UUID v4와 v7의 차이는 무엇인가요?

UUID v4 ID가 실제로 고유한가요?

UUID 버전 설명

UUID 구조

빠른 비교

코드에서 UUID 생성

UUID 버전 FAQ

References & cheat sheets

UUID 버전 설명

UUID 구조

빠른 비교

코드에서 UUID 생성

UUID 버전 FAQ