Guía · UUID generator

¿Qué es UUID? Formato, versiones y probabilidad de colisión

Qué es un UUID: el formato de 128 bits, cómo leer los dígitos de versión y variante, v4 o v7 como clave, colisiones reales y código en JS, Python y SQL.

Por Kola Oguntade · Actualizado: noviembre de 2026 · 6 min de lectura
550e8400-e29b-41d4v4

Un UUID (identificador único universal) es un número de 128 bits que sirve para etiquetar algo, como una fila de una base de datos o un archivo, sin que dos etiquetas choquen y sin que ninguna autoridad central tenga que repartirlas. Se escribe como 32 dígitos hexadecimales en cinco grupos separados por guiones, por ejemplo f81d4fae-7dec-11d0-a765-00a0c91e6bf6. Dicho en corto: un número enorme que cualquiera puede generar con la confianza de que será único.

El estándar vigente es la RFC 9562, publicada en mayo de 2024. Sustituyó a la RFC 4122, mantuvo las versiones anteriores y añadió tres nuevas (6, 7 y 8). También confirma que GUID, el nombre que se usa en los productos de Microsoft, se refiere a lo mismo.

Cómo está organizado un UUID

La forma en texto siempre tiene 36 caracteres: 32 dígitos hexadecimales más 4 guiones, agrupados 8-4-4-4-12. Cada dígito hexadecimal lleva 4 bits, así que 32 dígitos dan 128 bits, o 16 bytes. Valen tanto mayúsculas como minúsculas.

La mayoría de esos bits cambian según la versión, pero hay dos campos pequeños que ocupan el mismo lugar en todos los UUID estándar:

  • La versión es el decimotercer dígito hexadecimal, el primero del tercer grupo. Indica cómo se generó el UUID.
  • La variante es el decimoséptimo dígito hexadecimal, el primero del cuarto grupo. En los UUID que siguen la RFC 9562 siempre es 8, 9, a o b, porque los dos bits superiores están fijados en binario 10.

Toma el ejemplo de la documentación de PostgreSQL, 019535d9-3df7-79fb-b466-fa907fa17f9e. El tercer grupo empieza por 7, así que es un UUID de versión 7. El cuarto grupo empieza por b, que es la variante estándar. Y como la versión 7 guarda una marca de tiempo Unix en los primeros 48 bits, puedes decodificar los primeros 12 dígitos hexadecimales (019535d93df7) como 1.740.365.184.503 milisegundos, es decir, las 02:46:24.503 UTC del 24 de febrero de 2025. El ejemplo del principio de esta página tiene un 1 en la posición de la versión y una a en la de la variante, así que es un UUID de versión 1.

Como la versión y la variante ocupan 6 bits, a un UUID aleatorio le quedan 122 bits para el azar.

Las versiones de UUID y para qué sirve cada una

La RFC 9562 define ocho versiones. Las que más verás son v4 y v7, v1 en sistemas antiguos y las demás solo de vez en cuando.

VersiónCómo se generaUso habitual
1Marca de tiempo de 60 bits contada en pasos de 100 nanosegundos desde 1582, más una secuencia de reloj y un ID de nodo de 48 bits (a menudo la dirección MAC)Sistemas heredados
2Reservada para DCE Security; la RFC no la detallaPoco frecuente
3Hash MD5 de un espacio de nombres y un nombreLa misma entrada siempre da el mismo UUID
4122 bits aleatoriosIDs de uso general
5Hash SHA-1 de un espacio de nombres y un nombreComo v3, y preferible a ella
6Los campos de la versión 1 reordenados para que se ordenen por tiempoSistemas que ya usan v1
7Marca de tiempo Unix de 48 bits en milisegundos, seguida de bits aleatoriosClaves de bases de datos y todo lo que deba ordenarse por fecha de creación
8Estructura personalizada; solo la versión y la variante son fijasFormatos propios de un fabricante o experimentales

Hay además dos valores especiales: el UUID Nil, que es todo ceros, y el UUID Max, que es todo unos (todos los dígitos hexadecimales son f). Son útiles como marcadores de «sin valor» o de «límite superior».

La RFC es tajante con la versión 1. Las direcciones MAC plantean problemas de privacidad, y el estándar dice que, siempre que se pueda, se use la versión 7 en lugar de la 1 o la 6.

¿Qué probabilidad hay de un UUID duplicado?

Un UUID de versión 4 tiene 122 bits aleatorios, lo que da 2¹²² valores posibles, unos 5,3 × 10³⁶. Los duplicados siguen la paradoja del cumpleaños: la probabilidad de choque crece con el cuadrado de cuántos hayas generado, así que sube más rápido de lo que esperarías, pero desde una base minúscula.

Con la aproximación habitual, p ≈ 1 − exp(−n²/2N) con N = 2¹²², harían falta unos 2,71 × 10¹⁸ UUID (2,7 trillones) para tener un 50 % de probabilidad de un solo duplicado. Generando mil millones por segundo, eso lleva unos 86 años.

UUID generadosProbabilidad de al menos un duplicado
1 millónaproximadamente 1 entre 10²⁵ (9,4 × 10⁻²⁶)
Mil millones9,4 × 10⁻²⁰
1 billón9,4 × 10⁻¹⁴
Mil billones9,4 × 10⁻⁸
2,71 × 10¹⁸50 %

Las cuentas suponen una buena fuente de aleatoriedad. Los duplicados reales vienen de generadores débiles o mal inicializados, o de alguien que pega el mismo ID en dos sitios. Las colisiones al azar no merecen preocupación; los fallos de programación sí, y por eso sigue siendo buena idea poner una restricción de unicidad en la columna.

Único no es lo mismo que secreto. La RFC 9562 dice que no hay que dar por hecho que los UUID son difíciles de adivinar y que no deben usarse como credenciales de seguridad. Para un enlace de restablecimiento de contraseña o una clave de API, usa un token aleatorio específico; el generador de contraseñas es mejor punto de partida para cualquier cosa que deba mantenerse privada.

UUID v4 o v7 para claves de bases de datos

Esta es la decisión que importa en la práctica. Los dos tienen 128 bits y los dos están, a efectos prácticos, a salvo de colisiones. La diferencia es el orden.

Las claves v4 aleatorias caen en puntos al azar de un índice B-tree, así que cada inserción puede tocar una página distinta. La RFC 9562 dice que el coste de rendimiento de eso en los B-tree «puede ser drástico», y que los valores ordenados por tiempo pueden suponer una diferencia de un orden de magnitud o más. La versión 7 empieza por la marca de tiempo, así que las claves creadas una tras otra quedan juntas y se ordenan bien como bytes o como texto.

Mi opinión: usa v7 para las claves primarias de las tablas nuevas. Elige v4 cuando el ID vaya a ser público y no quieras que revele cuándo se creó el registro, porque cualquiera puede leer la marca de tiempo de un UUID v7, como se ha visto en el ejemplo de arriba. Elijas el que elijas, guárdalo en una columna UUID nativa o binaria de 16 bytes, no como texto. La RFC señala que la forma en texto ocupa 288 bits para guardar un valor de 128.

Cómo generar un UUID en JavaScript, Python y PostgreSQL

JavaScript

En el navegador, crypto.randomUUID() devuelve una cadena de versión 4 de 36 caracteres creada con un generador criptográficamente seguro. MDN advierte de que solo funciona en contextos seguros (HTTPS o localhost). Node.js tiene la misma función en su módulo crypto desde las versiones 14.17.0 y 15.6.0, y la documentación de Node.js incluye crypto.randomUUIDv7() desde la versión 26.1.0.

const id = crypto.randomUUID();

Python

El módulo uuid de la biblioteca estándar tiene uuid.uuid4() para UUID aleatorios. Python 3.14 añadió uuid.uuid7(), que incorpora una marca de tiempo de 48 bits y usa un contador para mantener el orden de los ID dentro del mismo milisegundo. Puedes comprobar la versión de cualquier UUID con el atributo .version.

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

PostgreSQL

gen_random_uuid() viene incluida desde PostgreSQL 13 y devuelve un UUID de versión 4. PostgreSQL 18 añadió uuidv4(), un alias de lo mismo, y uuidv7() para claves ordenadas por tiempo.

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

Crea UUID sin escribir código

Si solo necesitas unos cuantos ID para datos de prueba, un archivo de configuración o un arreglo rápido, el generador de UUID crea hasta 1000 de una vez, aleatorios v4 u ordenados por tiempo v7, con o sin guiones y en mayúsculas o minúsculas. Usa el generador aleatorio seguro de tu navegador, no se sube nada y es gratis, sin registro. Antes de pegar un lote en un script de datos iniciales, revisa el decimotercer carácter: si pediste v7 y ves un 4, has generado UUID de versión 4 por error.

¿Trabajas con ID dentro de JSON? El formateador de JSON hace mucho más fácil repasar cargas largas llenas de UUID.

También te puede servir: Generador de hash · Base64 decode y encode · URL encoder y decoder

Preguntas frecuentes

¿Un GUID es lo mismo que un UUID?

Sí. GUID (identificador único global) es el nombre que usa Microsoft, y la RFC 9562 trata los dos términos como la misma cosa: un valor de 128 bits escrito como 32 dígitos hexadecimales. Una diferencia que conviene conocer es que Microsoft COM guarda algunos campos en orden de bytes little-endian cuando almacena los GUID en binario.

¿Pueden coincidir dos UUID?

En teoría, sí. Un UUID de versión 4 tiene 122 bits aleatorios, así que harían falta unos 2,7 trillones para tener un 50 % de probabilidad de un solo duplicado. En la práctica, los duplicados vienen de generadores aleatorios defectuosos o de código copiado, no de la mala suerte.

¿Cómo sé qué versión es un UUID?

Mira el primer dígito del tercer grupo, el decimotercer dígito hexadecimal en total. Un 4 significa aleatorio, un 7 ordenado por tiempo y un 1 el formato antiguo de hora y dirección MAC. En un UUID estándar, el primer dígito del cuarto grupo debe ser 8, 9, a o b.

¿Uso UUID v4 o v7 como clave primaria?

Para tablas nuevas, v7 suele ser la mejor opción. Empieza con una marca de tiempo en milisegundos, así que las claves nuevas quedan juntas y las inserciones en el índice siguen siendo eficientes. Usa v4 cuando no quieras que el ID revele cuándo se creó el registro.

¿Los UUID son lo bastante seguros para usarlos como tokens secretos?

No. La RFC 9562 dice que las implementaciones no deben dar por hecho que los UUID son difíciles de adivinar y que no deben usarse como credenciales de seguridad, es decir, identificadores que dan acceso solo por tenerlos. Para enlaces de restablecimiento de contraseña o claves de API, usa un token aleatorio pensado para eso.

Más guías