Was ist eine UUID? Format, Versionen und Kollisionswahrscheinlichkeit erklärt
Was ist eine UUID? Das 128-Bit-Format, Version und Variante ablesen, v4 oder v7 als Datenbankschlüssel, echte Kollisionsrisiken und Code für JS, Python, SQL.
Eine UUID (Universally Unique Identifier) ist eine 128-Bit-Zahl, mit der man etwas kennzeichnet, etwa eine Datenbankzeile oder eine Datei, ohne dass sich zwei Kennungen überschneiden und ohne dass eine zentrale Stelle sie vergeben muss. Geschrieben wird sie als 32 Hexadezimalziffern in fünf Gruppen, getrennt durch Bindestriche, zum Beispiel f81d4fae-7dec-11d0-a765-00a0c91e6bf6. Kurz gesagt: eine sehr große Zahl, die jeder erzeugen kann und die trotzdem eindeutig sein sollte.
Der aktuelle Standard ist RFC 9562, veröffentlicht im Mai 2024. Er hat RFC 4122 abgelöst, die alten Versionen beibehalten und drei neue ergänzt (6, 7 und 8). Außerdem bestätigt er, dass GUID, der Name in Microsoft-Produkten, dasselbe meint.
So ist eine UUID aufgebaut
Die Textform hat immer 36 Zeichen: 32 Hex-Ziffern plus 4 Bindestriche, gruppiert als 8-4-4-4-12. Jede Hex-Ziffer trägt 4 Bit, 32 Ziffern ergeben also 128 Bit oder 16 Byte. Groß- und Kleinschreibung sind beide gültig.
Die meisten Bits ändern sich je nach Version, aber zwei kleine Felder sitzen in jeder Standard-UUID an derselben Stelle:
- Die Version ist die 13. Hex-Ziffer, die erste der dritten Gruppe. Sie verrät, wie die UUID erzeugt wurde.
- Die Variante ist die 17. Hex-Ziffer, die erste der vierten Gruppe. Bei UUIDs nach RFC 9562 ist sie immer 8, 9, a oder b, weil die obersten beiden Bits auf binär 10 festgelegt sind.
Nimm das Beispiel aus der PostgreSQL-Dokumentation, 019535d9-3df7-79fb-b466-fa907fa17f9e. Die dritte Gruppe beginnt mit 7, es ist also eine UUID der Version 7. Die vierte Gruppe beginnt mit b, das ist die Standardvariante. Und weil Version 7 in den ersten 48 Bit einen Unix-Zeitstempel ablegt, kannst du die ersten 12 Hex-Ziffern (019535d93df7) als 1.740.365.184.503 Millisekunden lesen, also 02:46:24,503 UTC am 24. Februar 2025. Das Beispiel oben auf dieser Seite hat eine 1 an der Versionsstelle und ein a an der Variantenstelle, ist also eine UUID der Version 1.
Da Version und Variante 6 Bit belegen, bleiben einer zufälligen UUID 122 Bit für den Zufall.
Die UUID-Versionen und wofür sie gedacht sind
RFC 9562 definiert acht Versionen. Am häufigsten begegnen dir v4 und v7, v1 in älteren Systemen, die anderen nur ab und zu.
| Version | Wie sie erzeugt wird | Typischer Einsatz |
|---|---|---|
| 1 | 60-Bit-Zeitstempel in Schritten von 100 Nanosekunden ab 1582, dazu eine Clock Sequence und eine 48-Bit-Node-ID (oft die MAC-Adresse) | Altsysteme |
| 2 | Für DCE Security reserviert; im RFC nicht näher beschrieben | Selten |
| 3 | MD5-Hash aus einem Namensraum und einem Namen | Dieselbe Eingabe ergibt immer dieselbe UUID |
| 4 | 122 Zufallsbits | IDs für alle möglichen Zwecke |
| 5 | SHA-1-Hash aus einem Namensraum und einem Namen | Wie v3, wird v3 aber vorgezogen |
| 6 | Felder von Version 1 so umsortiert, dass sie nach Zeit sortierbar sind | Systeme, die schon v1 nutzen |
| 7 | 48-Bit-Unix-Zeitstempel in Millisekunden, danach Zufallsbits | Datenbankschlüssel und alles, was nach Erstellungszeit sortiert sein soll |
| 8 | Eigenes Layout; nur Version und Variante sind festgelegt | Herstellerspezifische oder experimentelle Formate |
Dazu kommen zwei Sonderwerte: die Nil-UUID, die nur aus Nullen besteht, und die Max-UUID, die nur aus Einsen besteht (jede Hex-Ziffer ist f). Sie eignen sich als Markierung für „kein Wert“ oder „Obergrenze“.
Zu Version 1 äußert sich der RFC deutlich. MAC-Adressen werfen Datenschutzprobleme auf, und der Standard sagt, Implementierungen sollen wo möglich Version 7 statt 1 oder 6 verwenden.
Wie wahrscheinlich ist eine doppelte UUID?
Eine UUID der Version 4 hat 122 Zufallsbits, das ergibt 2¹²² mögliche Werte, etwa 5,3 × 10³⁶. Duplikate folgen dem Geburtstagsproblem: Die Wahrscheinlichkeit einer Kollision wächst mit dem Quadrat der erzeugten Anzahl. Sie steigt also schneller, als man denkt, aber von einem winzigen Ausgangswert.
Mit der üblichen Näherung p ≈ 1 − exp(−n²/2N) und N = 2¹²² bräuchtest du etwa 2,71 × 10¹⁸ UUIDs (2,7 Trillionen) für eine 50-prozentige Chance auf auch nur ein Duplikat. Bei einer Milliarde pro Sekunde dauert das etwa 86 Jahre.
| Erzeugte UUIDs | Wahrscheinlichkeit für mindestens ein Duplikat |
|---|---|
| 1 Million | etwa 1 zu 10²⁵ (9,4 × 10⁻²⁶) |
| 1 Milliarde | 9,4 × 10⁻²⁰ |
| 1 Billion | 9,4 × 10⁻¹⁴ |
| 1 Billiarde | 9,4 × 10⁻⁸ |
| 2,71 × 10¹⁸ | 50 % |
Die Rechnung setzt eine gute Zufallsquelle voraus. Echte Duplikate entstehen durch schwache oder schlecht initialisierte Generatoren oder weil jemand dieselbe ID an zwei Stellen einfügt. Zufällige Kollisionen sind keine Sorge wert, Bugs schon. Deshalb ist ein Unique Constraint auf der Spalte trotzdem eine gute Idee.
Eindeutig heißt nicht geheim. RFC 9562 sagt, man soll nicht davon ausgehen, dass UUIDs schwer zu erraten sind, und sie dürfen nicht als Sicherheitsmerkmal verwendet werden. Für einen Link zum Zurücksetzen des Passworts oder einen API-Schlüssel nimmst du ein eigenes Zufallstoken. Der Passwort-Generator ist ein besserer Ausgangspunkt für alles, was privat bleiben muss.
UUID v4 oder v7 als Datenbankschlüssel
Das ist die Entscheidung, auf die es in der Praxis ankommt. Beide haben 128 Bit, und bei beiden sind Kollisionen praktisch ausgeschlossen. Der Unterschied liegt in der Reihenfolge.
Zufällige v4-Schlüssel landen an beliebigen Stellen in einem B-Tree-Index, jede Einfügung kann also eine andere Seite treffen. RFC 9562 sagt, dass die Leistungseinbußen dadurch bei B-Trees „dramatisch“ sein können und dass zeitlich sortierte Werte einen Unterschied von einer Größenordnung oder mehr ausmachen können. Version 7 beginnt mit dem Zeitstempel, nacheinander erzeugte Schlüssel liegen also nebeneinander und sortieren korrekt, als reine Bytes oder als Text.
Meine Meinung: Nimm v7 für Primärschlüssel in neuen Tabellen. Greif zu v4, wenn die ID öffentlich sichtbar ist und nicht verraten soll, wann der Datensatz angelegt wurde. Aus einer v7-UUID kann nämlich jeder den Zeitstempel auslesen, wie das Beispiel oben gezeigt hat. Egal, wofür du dich entscheidest: Speicher sie in einer nativen UUID-Spalte oder als 16-Byte-Binärwert, nicht als Text. Der RFC weist darauf hin, dass die Textform 288 Bit braucht, um einen 128-Bit-Wert abzulegen.
UUIDs in JavaScript, Python und PostgreSQL erzeugen
JavaScript
Im Browser liefert crypto.randomUUID() einen 36 Zeichen langen String der Version 4 aus einem kryptografisch sicheren Generator. MDN weist darauf hin, dass das nur in sicheren Kontexten funktioniert (HTTPS oder localhost). Node.js hat dieselbe Funktion im Modul crypto seit den Versionen 14.17.0 und 15.6.0, und die Node.js-Dokumentation führt crypto.randomUUIDv7() ab Version 26.1.0.
const id = crypto.randomUUID();
Python
Das uuid-Modul der Standardbibliothek hat uuid.uuid4() für zufällige UUIDs. Python 3.14 hat uuid.uuid7() ergänzt, das einen 48-Bit-Zeitstempel einbettet und mit einem Zähler dafür sorgt, dass IDs innerhalb derselben Millisekunde in der richtigen Reihenfolge bleiben. Die Version einer beliebigen UUID prüfst du mit dem Attribut .version.
import uuid; uuid.uuid4(); uuid.uuid7()
PostgreSQL
gen_random_uuid() ist seit PostgreSQL 13 eingebaut und liefert eine UUID der Version 4. PostgreSQL 18 hat uuidv4() als Alias dafür ergänzt und uuidv7() für zeitlich sortierte Schlüssel.
CREATE TABLE orders (id uuid PRIMARY KEY DEFAULT uuidv7());
UUIDs erzeugen, ohne Code zu schreiben
Brauchst du nur ein paar IDs für Testdaten, eine Konfigurationsdatei oder eine schnelle Korrektur, erzeugt der UUID Generator bis zu 1.000 auf einmal, als zufällige v4 oder zeitlich sortierte v7, mit oder ohne Bindestriche, in Groß- oder Kleinbuchstaben. Er nutzt den sicheren Zufallsgenerator deines Browsers, nichts wird hochgeladen, und er ist kostenlos und ohne Anmeldung. Bevor du einen Stapel in ein Seed-Skript kopierst, prüf das 13. Zeichen: Wolltest du v7 und siehst eine 4, hast du versehentlich UUIDs der Version 4 erzeugt.
Arbeitest du mit IDs in JSON? Mit dem JSON-Formatierer lassen sich lange Payloads voller UUIDs viel leichter überblicken.
Auch nützlich: Hash-Generator · Base64 kodieren und dekodieren · URL Encoder und Decoder
Häufige Fragen
Ist eine GUID dasselbe wie eine UUID?
Ja. GUID (Globally Unique Identifier) ist der Name, den Microsoft verwendet, und RFC 9562 behandelt beide Begriffe als dasselbe: einen 128-Bit-Wert, geschrieben als 32 Hexadezimalziffern. Einen Unterschied solltest du kennen: Microsoft COM speichert einige Felder in Little-Endian-Bytereihenfolge, wenn GUIDs binär abgelegt werden.
Können zwei UUIDs gleich sein?
Theoretisch ja. Eine UUID der Version 4 hat 122 Zufallsbits. Für eine 50-prozentige Chance auf ein einziges Duplikat bräuchtest du etwa 2,7 Trillionen davon. In der Praxis entstehen Duplikate durch kaputte Zufallszahlengeneratoren oder kopierten Code, nicht durch Pech.
Woran erkenne ich, welche Version eine UUID hat?
Schau dir die erste Ziffer der dritten Gruppe an, also die 13. Hex-Ziffer insgesamt. Eine 4 steht für zufällig, eine 7 für zeitlich sortiert, eine 1 für das ältere Format mit Zeit und MAC-Adresse. Die erste Ziffer der vierten Gruppe sollte bei einer Standard-UUID 8, 9, a oder b sein.
Soll ich UUID v4 oder v7 als Primärschlüssel nehmen?
Für neue Datenbanktabellen ist v7 meist die bessere Wahl. Sie beginnt mit einem Zeitstempel in Millisekunden, neue Schlüssel liegen also beieinander und Einfügungen in den Index bleiben effizient. Nimm v4, wenn die ID nicht verraten soll, wann ein Datensatz angelegt wurde.
Sind UUIDs sicher genug als geheime Tokens?
Nein. RFC 9562 sagt, Implementierungen sollen nicht davon ausgehen, dass UUIDs schwer zu erraten sind, und dürfen sie nicht als Sicherheitsmerkmal (Security Capability) verwenden, also als Kennung, deren bloßer Besitz Zugriff gewährt. Für Links zum Zurücksetzen von Passwörtern oder API-Schlüssel nimmst du besser ein eigens dafür erzeugtes Zufallstoken.