¿Qué es un UUID?
Un UUID (Universally Unique Identifier) es un identificador de 128 bits que se representa como 36 caracteres: 32 dígitos hexadecimales agrupados en bloques de 8-4-4-4-12 y separados por guiones, por ejemplo 3f2504e0-4f89-41d3-9a0c-0305e82c3301. Su gracia es que puedes crear identificadores únicos sin coordinarte con nadie: ni bases de datos centrales, ni contadores compartidos, ni riesgo razonable de colisión.
Eso lo convierte en el estándar de facto para claves primarias en bases de datos distribuidas, IDs de sesión, nombres únicos de archivos subidos, cabeceras de trazabilidad (X-Request-Id) y claves idempotentes en APIs de pago.
Diferencias entre UUID v1, v4 y v7
| Versión | Fuente de unicidad | Ordenable | Uso típico |
|---|---|---|---|
v1 | Marca de tiempo + reloj + nodo (MAC) | Parcial | Sistemas legados, trazabilidad temporal |
v4 | Aleatorio (122 bits) | No | Tokens, IDs genéricos, el más común |
v7 | Tiempo Unix (ms) + aleatorio | Sí | Bases de datos modernas, logs, eventos |
Los bits de versión ocupan la posición 13 del string (el primer dígito del tercer bloque) y la variante — aquí siempre 10xx — el dígito 17. Si miras cualquier UUID generado aquí verás esos campos respetados al byte.
Casos de uso en desarrollo
- Claves primarias: permite generar registros en varios nodos sin esperar a la base de datos central. Con v7 además mantienes los índices B-tree compactos porque los valores llegan casi ordenados.
- Idempotencia en APIs: envía un UUID por petición para que el servidor pueda deduplicar reintentos (patrón
Idempotency-Key). - Nombres de archivo seguros: renombra subidas de usuarios a un UUID para evitar rutas predecibles y colisiones de nombre.
- Trazas distribuidas: propaga un mismo ID entre microservicios para seguir una petición de extremo a extremo.
Preguntas frecuentes
¿Qué es un UUID y para qué sirve?
Es un identificador de 128 bits representado como 36 caracteres hexadecimales. Sirve para etiquetar recursos de forma única sin autoridad central: claves primarias, sesiones, archivos, trazas distribuidas y más.
¿Qué diferencia hay entre UUID v1, v4 y v7?
La v1 usa marca de tiempo y MAC; la v4 es completamente aleatoria y la más usada; la v7 combina tiempo Unix en milisegundos con aleatoriedad, así ordena cronológicamente y es ideal para índices de bases de datos modernas.
¿Es seguro usar UUID v4 como token secreto?
Una v4 generada con un generador criptográficamente seguro tiene 122 bits de entropía y sirve como token o clave provisional. Para secretos de larga vida conviene mayor longitud.
¿Pueden colisionar dos UUIDs?
En teoría sí, pero la probabilidad es despreciable: con 100.000 millones de v4 la probabilidad de colisión ronda uno entre mil millones. En la práctica se consideran únicos.
¿Por qué elegir UUID v7 para bases de datos?
Sus primeros bytes codifican el tiempo, así que se ordenan casi secuencialmente: menos fragmentación en índices B-tree y mejores escrituras que con v4 aleatorias.
¿Se guardan los UUID que genero en esta página?
No. Todo se genera en tu navegador con la Web Crypto API. Solo tu historial reciente vive en localStorage y puedes borrarlo con un clic.
¿Listo para generar tus identificadores?
Elige versión, ajusta el formato y pulsa Enter. Copia fila a fila, copia todo de golpe o descarga un .txt.