¿Qué es un UUID? v4 vs v7 y cuándo usar cada uno

Un UUID es un ID único que puedes crear en cualquier lugar sin consultar a un servidor. Así funcionan las versiones 4 y 7 y cuál encaja en tu proyecto.

Desarrollo 7 min de lectura

Tarde o temprano toda aplicación necesita identificadores únicos para usuarios, pedidos, archivos o eventos. Un contador funciona hasta que tienes más de una base de datos, un cliente sin conexión o una API pública que no debe revelar cuántos registros hay. Ahí entran los UUID.

En esta guía aprenderás qué es un UUID, en qué se diferencia la versión 4 (aleatoria) de la versión 7 (ordenada por tiempo), por qué la v7 suele ser la mejor opción para claves primarias y cómo evitar los errores más comunes.

Genera UUID ahora Crea uno o varios UUID en tu navegador. No se envía nada a ningún servidor. Abrir el generador de UUID

¿Qué es un UUID (o GUID)?

Un UUID (Universally Unique Identifier, o identificador único universal), llamado también GUID en el mundo Microsoft, es un valor de 128 bits que sirve para identificar algo. Normalmente se escribe como 32 dígitos hexadecimales separados por guiones en cinco grupos, con el patrón 8-4-4-4-12, lo que da 36 caracteres en total.

Ejemplo: 018f4e2a-7c3b-7d4e-9a1b-2c3d4e5f6a7b. Un dígito indica la versión (el primero del tercer grupo) y unos pocos bits marcan la variante; el resto lleva los datos propiamente dichos.

¿Por qué usar UUID?

  • Sin contador central: cualquier servidor, dispositivo o navegador crea un ID por sí solo, sin pedirle a la base de datos el siguiente número.
  • Seguros en sistemas distribuidos: varios servicios, regiones o clientes sin conexión crean registros y los unen después sin choques.
  • Se generan antes de guardar: el cliente conoce el ID del nuevo registro antes de que el servidor lo confirme, lo que simplifica las apps offline y los reintentos.
  • No revelan el número de filas: un ID como 1042 muestra a cualquiera cuántos registros hay y facilita adivinar los vecinos. Un UUID no.

UUID v4: totalmente aleatorio

La versión 4 es la más común. Aparte de los pocos bits que marcan versión y variante, los otros 122 bits son aleatorios. No hay orden, ni fecha, ni información de la máquina que lo creó.

Eso hace que la v4 sea sencilla, muy compatible y una buena opción general, sobre todo cuando no quieres que el ID revele cuándo se creó algo.

UUID v7: ordenado por tiempo y aleatorio

La versión 7 se estandarizó en la RFC 9562 (2024), que actualizó la especificación anterior de UUID. Sus primeros 48 bits guardan una marca de tiempo Unix en milisegundos y la mayor parte del resto son bits aleatorios.

Como la marca de tiempo va primero, los valores v7 se ordenan por fecha de creación: un UUID creado después es mayor que uno creado antes (con precisión de milisegundo). Y sigues generándolo sin ninguna coordinación central.

En resumen: la v4 es todo aleatoriedad; la v7 es "primero la marca de tiempo, luego aleatorio".

Por qué la v7 es mejor para claves primarias

La mayoría de las bases de datos guardan la clave primaria en un índice ordenado por valor. Con claves v4 aleatorias, cada fila nueva cae en un punto cualquiera del índice, lo que provoca divisiones de página, más fragmentación, peor uso de la caché e inserciones más lentas en tablas grandes.

Con la v7, las claves nuevas quedan siempre cerca del final del índice, igual que un número autoincremental. Conservas las ventajas del UUID y ganas mucha más localidad en el índice. Los listados de lo más reciente y las consultas por rango de tiempo también resultan más fáciles.

La contrapartida: una v7 revela aproximadamente cuándo se creó el registro. Si eso es sensible, usa v4 o no expongas el UUID en URL públicas.

Otras versiones, en breve

  • v1: se construye con una marca de tiempo más un identificador de nodo, históricamente la dirección MAC. Puede filtrar información de la máquina y hoy rara vez se recomienda.
  • v5: basada en nombre. Aplica SHA-1 a un espacio de nombres y un nombre, así que la misma entrada siempre da el mismo UUID. Útil para IDs deterministas.
  • La v3 es la misma idea que la v5 pero con MD5, y la v6 es una v1 reordenada. En proyectos nuevos normalmente elegirás v4 o v7.

¿Pueden chocar dos UUID?

En teoría sí; en la práctica la probabilidad es despreciable. Con 122 bits aleatorios en una v4, habría que generar una cantidad enorme de IDs para que un duplicado sea siquiera remotamente probable, muchísimos más de los que casi cualquier sistema creará.

Eso supone una buena fuente de aleatoriedad. Usa el generador aleatorio seguro de tu plataforma, no uno casero. Si la unicidad es crítica, mantén de todos modos una restricción única en la columna.

UUID vs autoincremental

  • El autoincremental es pequeño (4 u 8 bytes), rápido, legible y perfecto para una sola base de datos. Pero necesita una autoridad que reparta los números y expone volumen y orden.
  • Los UUID ocupan 16 bytes, son más difíciles de leer y escribir y agrandan los índices. A cambio funcionan entre sistemas y no se pueden adivinar.
  • Un término medio habitual es una clave autoincremental interna más un UUID como identificador público. Otro es usar directamente v7 como clave primaria.

Cómo generar UUID con la herramienta gratuita

  1. Abre el generador de UUID. Funciona por completo en tu navegador, así que no se envía nada a un servidor.
  2. Elige la versión que necesitas (v4 o v7) y cuántos UUID crear.
  3. Genera y copia uno o toda la lista en tu código, en el seed de tu base de datos o en datos de prueba.

Errores comunes que debes evitar

  • Usar un UUID como secreto o token de acceso. Un UUID es un identificador, no una credencial. La v7 es en parte predecible por su marca de tiempo y ni siquiera la v4 se diseñó para autenticar. Para eso usa un token aleatorio adecuado.
  • Confiar en el UUID de la URL como único control de acceso. Comprueba siempre los permisos.
  • Guardar los UUID como texto de 36 caracteres cuando la base de datos tiene un tipo nativo (como UUID en PostgreSQL) o una columna binaria de 16 bytes. Desperdicia espacio y ralentiza los índices.
  • Mezclar v4 y v7 en la misma columna esperando orden por tiempo.
  • Escribir tu propio generador con Math.random() u otra aleatoriedad débil.

Conclusión

Un UUID te da IDs únicos sin contador central. Usa v7 cuando el ID sea clave primaria y el orden por tiempo ayude, usa v4 cuando quieras aleatoriedad pura y sin fecha de creación, y nunca trates ninguno como un secreto. Guárdalos en una columna nativa o binaria y genéralos con nuestra herramienta gratuita cuando los necesites.

Preguntas frecuentes

¿Cuál es la diferencia entre UUID y GUID?

Son lo mismo. GUID es el nombre que se usa sobre todo en entornos Microsoft; UUID es el nombre estándar. Ambos son identificadores de 128 bits.

¿Debo usar UUID v4 o v7?

Usa v7 para claves primarias de bases de datos y siempre que ordenar por creación sea útil. Usa v4 para uso general o cuando no quieras que el ID revele cuándo se creó.

¿Es seguro usar un UUID como contraseña o token?

No. Un UUID sirve para identificar, no para proteger. Para tokens de sesión, claves de API o restablecer contraseñas usa un token largo de un generador aleatorio criptográficamente seguro.

¿Pueden chocar los UUID?

En la práctica la probabilidad es despreciable si se generan con buena aleatoriedad. Mantén una restricción de unicidad en la base de datos como red de seguridad.

¿El generador envía mis UUID a un servidor?

No. Los UUID se crean localmente en tu navegador y no se envían ni se guardan en ningún sitio.

Herramientas gratuitas mencionadas en este artículo

Sigue leyendo

Todos los artículos