Guide · Générateur d’UUID

UUID, c’est quoi ? Format, versions et risque de collision

UUID, c’est quoi : le format 128 bits, les chiffres de version et de variante, v4 ou v7 pour une clé en base, le vrai risque de doublon, code JS, Python, SQL.

Par Kola Oguntade · Mis à jour : novembre 2026 · 6 min de lecture
550e8400-e29b-41d4v4

Un UUID (universally unique identifier, ou identifiant unique universel) est un nombre de 128 bits qui sert à étiqueter quelque chose, une ligne de base de données ou un fichier par exemple, sans que deux étiquettes entrent en conflit et sans autorité centrale pour les distribuer. Il s’écrit en 32 chiffres hexadécimaux répartis en cinq groupes séparés par des tirets, comme f81d4fae-7dec-11d0-a765-00a0c91e6bf6. En résumé : un nombre très grand, que n’importe qui peut générer en comptant sur son unicité.

La norme actuelle est la RFC 9562, publiée en mai 2024. Elle remplace la RFC 4122, conserve les anciennes versions et en ajoute trois (6, 7 et 8). Elle confirme aussi que GUID, le nom utilisé dans les produits Microsoft, désigne la même chose.

La structure d’un UUID

La forme texte fait toujours 36 caractères : 32 chiffres hexadécimaux plus 4 tirets, groupés en 8-4-4-4-12. Chaque chiffre hexadécimal porte 4 bits, donc 32 chiffres font 128 bits, soit 16 octets. Majuscules et minuscules sont toutes deux valides.

La plupart de ces bits changent selon la version, mais deux petits champs occupent la même place dans tout UUID standard :

  • La version est le 13e chiffre hexadécimal, le premier du troisième groupe. Elle indique comment l’UUID a été créé.
  • La variante est le 17e chiffre hexadécimal, le premier du quatrième groupe. Pour les UUID conformes à la RFC 9562, c’est toujours 8, 9, a ou b, parce que les deux bits de poids fort sont fixés à 10 en binaire.

Prenons l’exemple de la documentation PostgreSQL, 019535d9-3df7-79fb-b466-fa907fa17f9e. Le troisième groupe commence par 7 : c’est un UUID de version 7. Le quatrième groupe commence par b, la variante standard. Et comme la version 7 place un horodatage Unix dans les 48 premiers bits, on peut décoder les 12 premiers chiffres hexadécimaux (019535d93df7) : 1 740 365 184 503 millisecondes, soit le 24 février 2025 à 02:46:24.503 UTC. L’exemple en haut de cette page a un 1 à l’emplacement de la version et un a à celui de la variante : c’est un UUID de version 1.

Comme la version et la variante occupent 6 bits, il reste 122 bits d’aléatoire dans un UUID aléatoire.

Les versions d’UUID et leur usage

La RFC 9562 définit huit versions. Vous croiserez surtout v4 et v7, v1 dans les systèmes anciens, et les autres de temps en temps seulement.

VersionMode de créationUsage courant
1Horodatage de 60 bits compté par pas de 100 nanosecondes depuis 1582, plus une séquence d’horloge et un identifiant de nœud de 48 bits (souvent l’adresse MAC)Systèmes anciens
2Réservée à DCE Security ; non détaillée dans la RFCRare
3Hachage MD5 d’un espace de noms et d’un nomLa même entrée donne toujours le même UUID
4122 bits aléatoiresIdentifiants à usage général
5Hachage SHA-1 d’un espace de noms et d’un nomComme v3, à laquelle on la préfère
6Champs de la version 1 réordonnés pour un tri chronologiqueSystèmes qui utilisent déjà v1
7Horodatage Unix de 48 bits en millisecondes, suivi de bits aléatoiresClés de base de données et tout ce qui doit se trier par date de création
8Structure libre ; seules la version et la variante sont fixéesFormats propriétaires ou expérimentaux

Il existe aussi deux valeurs spéciales : l’UUID Nil, composé uniquement de zéros, et l’UUID Max, composé uniquement de uns (chaque chiffre hexadécimal vaut f). Elles servent de marqueurs « aucune valeur » ou « borne supérieure ».

La RFC ne prend pas de gants avec la version 1. Les adresses MAC posent des problèmes de confidentialité, et la norme demande d’utiliser la version 7 plutôt que la 1 ou la 6 chaque fois que c’est possible.

Quel est le risque d’obtenir deux UUID identiques ?

Un UUID de version 4 compte 122 bits aléatoires, soit 2¹²² valeurs possibles, environ 5,3 × 10³⁶. Les doublons suivent le paradoxe des anniversaires : le risque de collision croît avec le carré du nombre d’UUID générés, donc plus vite qu’on ne l’imagine, mais à partir d’une base minuscule.

Avec l’approximation classique, p ≈ 1 − exp(−n²/2N) où N = 2¹²², il faudrait environ 2,71 × 10¹⁸ UUID (2,7 milliards de milliards) pour avoir 50 % de chances d’un seul doublon. À un milliard par seconde, cela prendrait environ 86 ans.

UUID générésProbabilité d’au moins un doublon
1 millionenviron 1 sur 10²⁵ (9,4 × 10⁻²⁶)
1 milliard9,4 × 10⁻²⁰
1 000 milliards9,4 × 10⁻¹⁴
1 million de milliards9,4 × 10⁻⁸
2,71 × 10¹⁸50 %

Ce calcul suppose une bonne source d’aléatoire. Les vrais doublons viennent de générateurs faibles ou mal initialisés, ou de quelqu’un qui colle le même identifiant à deux endroits. Les collisions aléatoires ne méritent pas qu’on s’en inquiète, les bugs si : d’où l’intérêt de garder une contrainte d’unicité sur la colonne.

Unique ne veut pas dire secret. La RFC 9562 indique qu’il ne faut pas supposer les UUID difficiles à deviner et qu’ils ne doivent pas servir de capacités de sécurité. Pour un lien de réinitialisation de mot de passe ou une clé d’API, utilisez un jeton aléatoire dédié ; le générateur de mots de passe est un meilleur point de départ pour tout ce qui doit rester privé.

UUID v4 ou v7 pour une clé de base de données

C’est le choix qui compte en pratique. Les deux font 128 bits et les deux sont, dans les faits, à l’abri des collisions. La différence tient à l’ordre.

Les clés v4 aléatoires atterrissent n’importe où dans un index B-tree, si bien que chaque insertion peut toucher une page différente. La RFC 9562 qualifie ce coût en performances de « spectaculaire » sur les B-trees, et indique que des valeurs ordonnées dans le temps peuvent faire gagner un ordre de grandeur, voire plus. La version 7 commence par l’horodatage : les clés créées à la suite se retrouvent côte à côte et se trient correctement, en octets bruts comme en texte.

Mon avis : utilisez v7 pour les clés primaires des nouvelles tables. Choisissez v4 quand l’identifiant sera public et que vous ne voulez pas qu’il révèle la date de création de l’enregistrement, car n’importe qui peut lire l’horodatage d’un UUID v7, comme le montre l’exemple plus haut. Dans les deux cas, stockez-le dans une colonne UUID native ou binaire de 16 octets plutôt qu’en texte. La RFC fait remarquer que la forme texte occupe 288 bits pour une valeur de 128 bits.

Générer un UUID en JavaScript, en Python et sous PostgreSQL

JavaScript

Dans le navigateur, crypto.randomUUID() renvoie une chaîne de version 4 de 36 caractères, issue d’un générateur cryptographiquement sûr. MDN précise que la fonction n’est disponible que dans un contexte sécurisé (HTTPS ou localhost). Node.js propose la même fonction dans son module crypto depuis les versions 14.17.0 et 15.6.0, et la documentation de Node.js mentionne crypto.randomUUIDv7() à partir de la version 26.1.0.

const id = crypto.randomUUID();

Python

Le module uuid de la bibliothèque standard fournit uuid.uuid4() pour les UUID aléatoires. Python 3.14 a ajouté uuid.uuid7(), qui intègre un horodatage de 48 bits et utilise un compteur pour garder l’ordre des identifiants créés dans la même milliseconde. L’attribut .version donne la version de n’importe quel UUID.

import uuid; uuid.uuid4(); uuid.uuid7()

PostgreSQL

gen_random_uuid() est intégré depuis PostgreSQL 13 et renvoie un UUID de version 4. PostgreSQL 18 a ajouté uuidv4(), un alias de la même fonction, et uuidv7() pour des clés ordonnées dans le temps.

CREATE TABLE orders (id uuid PRIMARY KEY DEFAULT uuidv7());

Créer des UUID sans écrire de code

Si vous n’avez besoin que de quelques identifiants pour des données de test, un fichier de configuration ou une correction rapide, le générateur d’UUID en crée jusqu’à 1 000 d’un coup, en v4 aléatoire ou en v7 ordonné dans le temps, avec ou sans tirets, en majuscules ou en minuscules. Il utilise le générateur aléatoire sécurisé de votre navigateur, rien n’est envoyé sur un serveur, et il est gratuit, sans inscription. Avant de coller un lot dans un script de peuplement, vérifiez le 13e caractère : si vous avez demandé du v7 et que vous voyez un 4, vous avez généré des UUID de version 4 par erreur.

Vous manipulez des identifiants dans du JSON ? Le formateur JSON rend bien plus lisibles les longues charges utiles truffées d’UUID.

Également utile: Générateur de hash · Base64 : encoder et décoder · Encoder et décoder une URL

Questions fréquentes

Un GUID est-il la même chose qu’un UUID ?

Oui. GUID (globally unique identifier) est le nom employé par Microsoft, et la RFC 9562 considère les deux termes comme équivalents : une valeur de 128 bits écrite en 32 chiffres hexadécimaux. Une différence à connaître : Microsoft COM stocke certains champs en ordre little-endian quand il enregistre les GUID en binaire.

Deux UUID peuvent-ils être identiques ?

En théorie, oui. Un UUID de version 4 compte 122 bits aléatoires : il en faudrait environ 2,7 milliards de milliards pour avoir 50 % de chances d’obtenir un seul doublon. En pratique, les doublons viennent de générateurs aléatoires défaillants ou de code copié, pas de la malchance.

Comment savoir de quelle version est un UUID ?

Regardez le premier chiffre du troisième groupe, soit le 13e chiffre hexadécimal. Un 4 signifie aléatoire, un 7 ordonné dans le temps, un 1 l’ancien format basé sur l’heure et l’adresse MAC. Le premier chiffre du quatrième groupe doit être 8, 9, a ou b pour un UUID standard.

UUID v4 ou v7 pour une clé primaire ?

Pour les nouvelles tables, v7 est en général le meilleur choix. Il commence par un horodatage en millisecondes : les nouvelles clés se suivent et les insertions dans l’index restent efficaces. Prenez v4 si vous ne voulez pas que l’identifiant révèle la date de création de l’enregistrement.

Un UUID est-il assez sûr pour servir de jeton secret ?

Non. La RFC 9562 indique qu’il ne faut pas supposer qu’un UUID est difficile à deviner, et qu’il ne doit pas servir de capacité de sécurité, c’est-à-dire d’identifiant dont la simple possession donne accès à quelque chose. Pour un lien de réinitialisation de mot de passe ou une clé d’API, utilisez un jeton aléatoire prévu pour cela.

Autres guides