Generador y Decodificador de UUID — v1, v4, v5, v7 Modo Lote

¿Qué es un UUID?

// Generate a UUID v4 using the Web Crypto API
const uuid = crypto.randomUUID();
console.log(uuid);
// → '550e8400-e29b-41d4-a716-446655440000'

// Manual v4 generation with crypto.getRandomValues()
function generateUUIDv4() {
  const bytes = new Uint8Array(16);
  crypto.getRandomValues(bytes);
  bytes[6] = (bytes[6] & 0x0f) | 0x40; // version 4
  bytes[8] = (bytes[8] & 0x3f) | 0x80; // variant 10
  const hex = Array.from(bytes, b => b.toString(16).padStart(2, '0')).join('');
  return `${hex.slice(0,8)}-${hex.slice(8,12)}-${hex.slice(12,16)}-${hex.slice(16,20)}-${hex.slice(20)}`;
}

Características principales

Comparación de versiones de UUID

Elige la versión de UUID correcta para tu caso de uso.

UUID vs otros formatos de ID

Ejemplos de versiones de UUID

550e8400-e29b-41d4-a716-446655440000

01906b5e-4a3e-7234-8f56-b8c12d4e5678

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

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

Cómo usar

1. 1

   Selecciona la versión de UUID

   Elige entre v1 (basado en tiempo), v3 (basado en nombre MD5), v4 (aleatorio), v5 (basado en nombre SHA-1) o v7 (aleatorio ordenado por tiempo). Cada versión tiene un propósito diferente — v4 es la más común para uso general.

2. 2

   Configura las opciones

   Para v3 y v5, selecciona un espacio de nombres (DNS, URL, OID, X.500 o personalizado) e introduce un nombre para hashear. Establece la cantidad de 1 a 50 y elige un formato de salida: minúsculas estándar, MAYÚSCULAS, sin guiones o con llaves {GUID}.

3. 3

   Genera los UUIDs

   Haz clic en el botón Generar. Cada UUID se crea usando la Web Crypto API (crypto.getRandomValues()) para seguridad criptográfica. Los campos específicos de cada versión como las marcas de tiempo (v1/v7) y los hashes (v3/v5) se codifican correctamente.

4. 4

   Copia y usa

   Haz clic en el botón Copiar junto a cualquier UUID para copiarlo al portapapeles, o usa Copiar Todo para obtener todos los UUIDs generados de una vez. Cambia a la pestaña Decodificar para analizar la versión, variante, marca de tiempo y otra información incrustada de un UUID existente.

Casos de uso comunes

Claves primarias de bases de datos

Usa UUID v4 o v7 como claves primarias únicas sin coordinación entre nodos de base de datos. UUID v7 es especialmente adecuado porque su propiedad de ordenación por tiempo mejora el rendimiento del índice B-tree.

Sistemas distribuidos

Genera identificadores únicos de forma independiente en microservicios, colas de mensajes y sistemas de sourcing de eventos. Los UUIDs eliminan la necesidad de un servicio centralizado de generación de IDs.

Desarrollo de APIs

Crea IDs de solicitud únicos, IDs de correlación y claves de idempotencia para APIs RESTful y GraphQL. Los UUIDs facilitan el rastreo de solicitudes a través de los límites de servicios distribuidos.

Gestión de sesiones y tokens

Genera identificadores de sesión únicos y tokens temporales para flujos de autenticación. Los UUIDs proporcionan suficiente unicidad para prevenir colisiones de sesiones en grandes bases de usuarios.

Pruebas y desarrollo

Genera rápidamente datos de prueba, identificadores simulados e IDs únicos de fixtures para pruebas automatizadas. La generación en lote facilita poblar bases de datos de desarrollo y suites de pruebas.

Detalles técnicos

Estructura del UUID

Un UUID tiene 128 bits (16 bytes) representados como 32 caracteres hexadecimales en el formato 8-4-4-4-12. Los bits 48-51 (el 13.° dígito hexadecimal) codifican el número de versión. Los bits 64-65 codifican el campo de variante, que identifica el diseño del UUID. Los bits restantes llevan la carga útil específica de la versión: marca de tiempo, datos aleatorios o salida de hash.

Bits de versión

Los bits 48-51 (el nibble alto del 7.° byte) codifican la versión del UUID: 0001 = v1 (basado en tiempo), 0011 = v3 (basado en nombre MD5), 0100 = v4 (aleatorio), 0101 = v5 (basado en nombre SHA-1), 0110 = v6 (tiempo reordenado), 0111 = v7 (tiempo de época Unix). Estos cuatro bits siempre se establecen explícitamente durante la generación.

Campo de variante

Los bits 64-65 (los dos bits más significativos del 9.° byte) definen la variante. El patrón 10x indica UUIDs RFC 4122/9562 (la gran mayoría). El patrón 110 indica GUIDs de Microsoft con orden de bytes mixed-endian. El patrón 0xx indica UUIDs compatibles con NCS heredados. El patrón 111 está reservado para uso futuro.

Estándar RFC 9562

RFC 9562, publicado en mayo de 2024, reemplaza a RFC 4122 como la especificación definitiva de UUID. Introduce formalmente las versiones 6, 7 y 8 de UUID. La versión 6 reordena los campos de v1 para ordenabilidad. La versión 7 usa una marca de tiempo Unix de 48 bits en milisegundos más datos aleatorios, siendo la versión recomendada para nuevos UUIDs basados en tiempo. La versión 8 proporciona un formato para UUIDs personalizados específicos de implementación. RFC 9562 también depreca formalmente v1 en favor de v6/v7.

Buenas prácticas

Elige la versión correcta

Usa v4 para identificadores únicos de propósito general donde no se necesita orden ni determinismo. Usa v7 para claves primarias de bases de datos — su propiedad de ordenación por tiempo ofrece un rendimiento de índice significativamente mejor. Usa v5 cuando necesites IDs deterministas derivados de nombres (prefiere v5 sobre v3 para un hashing más fuerte).

Usa UUID v7 para claves primarias de bases de datos

La estructura ordenada por tiempo de UUID v7 mantiene las inserciones B-tree secuenciales, reduciendo la fragmentación del índice aproximadamente un 90% en comparación con los UUIDs v4 aleatorios. Esto se traduce en escrituras más rápidas, índices más pequeños y mejor utilización de la caché. La mayoría de las bases de datos modernas (PostgreSQL 17+, MySQL 8.0+) tienen soporte nativo de UUID optimizado para este patrón.

Nunca uses UUIDs como tokens de seguridad

Los UUIDs están diseñados para unicidad, no para secreto. UUID v1 filtra la marca de tiempo de generación y la dirección MAC. UUID v4 tiene solo 122 bits de entropía con una estructura predecible. Para tokens de seguridad, claves de API o secretos de sesión, usa un CSPRNG dedicado para generar 128 o 256 bits de datos puramente aleatorios sin la sobrecarga de la estructura UUID.

Valida antes de analizar

Siempre valida el formato UUID con una expresión regular antes de analizar o almacenar. Rechaza entradas malformadas en los límites del sistema — endpoints de API, envíos de formularios y entradas de bases de datos. Esto previene ataques de inyección, corrupción de datos y errores difíciles de depurar por identificadores no válidos que se propagan por el sistema.

Preguntas frecuentes