Gerador e Decodificador de UUID — v1, v4, v5, v7 em Lote

O Que É um 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)}`;
}

Recursos Principais

Comparação de Versões de UUID

Escolha a versão certa de UUID para o seu caso de uso.

UUID vs Outros Formatos de ID

Exemplos de Versões de UUID

550e8400-e29b-41d4-a716-446655440000

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

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

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

Como Usar

1. 1

   Selecione a Versão do UUID

   Escolha entre v1 (baseado em tempo), v3 (baseado em nome MD5), v4 (aleatório), v5 (baseado em nome SHA-1) ou v7 (aleatório ordenado por tempo). Cada versão serve a um propósito diferente — v4 é a mais comum para uso geral.

2. 2

   Configure as Opções

   Para v3 e v5, selecione um namespace (DNS, URL, OID, X.500 ou personalizado) e insira um nome para gerar o hash. Defina a quantidade de 1 a 50 e escolha um formato de saída: minúsculas padrão, MAIÚSCULAS, sem hífens ou com chaves {GUID}.

3. 3

   Gere os UUIDs

   Clique no botão Gerar. Cada UUID é criado usando a Web Crypto API (crypto.getRandomValues()) para segurança criptográfica. Os campos específicos de cada versão, como timestamps (v1/v7) e hashes (v3/v5), são codificados corretamente.

4. 4

   Copie e Use

   Clique no botão Copiar ao lado de qualquer UUID para copiá-lo para a área de transferência, ou use Copiar Tudo para pegar todos os UUIDs gerados de uma vez. Mude para a aba Decodificar para analisar a versão, variante, timestamp e outras informações incorporadas de um UUID existente.

Casos de Uso Comuns

Chaves Primárias de Banco de Dados

Use UUID v4 ou v7 como chaves primárias únicas sem coordenação entre nós do banco de dados. UUID v7 é especialmente adequado porque sua propriedade de ordenação temporal melhora o desempenho de índices B-tree.

Sistemas Distribuídos

Gere identificadores únicos de forma independente entre microsserviços, filas de mensagens e sistemas de event sourcing. UUIDs eliminam a necessidade de um serviço centralizado de geração de IDs.

Desenvolvimento de APIs

Crie IDs de requisição únicos, IDs de correlação e chaves de idempotência para APIs RESTful e GraphQL. UUIDs facilitam o rastreamento de requisições através de fronteiras de serviços distribuídos.

Gerenciamento de Sessões e Tokens

Gere identificadores de sessão e tokens temporários únicos para fluxos de autenticação. UUIDs fornecem unicidade suficiente para evitar colisões de sessão em grandes bases de usuários.

Testes e Desenvolvimento

Gere rapidamente dados de teste, identificadores mock e IDs únicos de fixtures para testes automatizados. A geração em lote facilita o preenchimento de bancos de dados de desenvolvimento e suítes de teste.

Detalhes Técnicos

Estrutura do UUID

Um UUID é de 128 bits (16 bytes) representado como 32 caracteres hexadecimais no formato 8-4-4-4-12. Os bits 48-51 (o 13° dígito hexadecimal) codificam o número da versão. Os bits 64-65 codificam o campo de variante, que identifica o layout do UUID. Os bits restantes carregam o payload específico da versão: timestamp, dados aleatórios ou saída de hash.

Bits de Versão

Os bits 48-51 (o nibble alto do 7° byte) codificam a versão do UUID: 0001 = v1 (baseado em tempo), 0011 = v3 (baseado em nome MD5), 0100 = v4 (aleatório), 0101 = v5 (baseado em nome SHA-1), 0110 = v6 (tempo reordenado), 0111 = v7 (tempo época Unix). Esses quatro bits são sempre definidos explicitamente durante a geração.

Campo de Variante

Os bits 64-65 (os dois bits mais significativos do 9° byte) definem a variante. O padrão 10x indica UUIDs RFC 4122/9562 (a grande maioria). O padrão 110 indica GUIDs Microsoft com ordem de bytes mixed-endian. O padrão 0xx indica UUIDs compatíveis com NCS (legado). O padrão 111 é reservado para uso futuro.

Padrão RFC 9562

A RFC 9562, publicada em maio de 2024, substitui a RFC 4122 como a especificação definitiva de UUID. Ela introduz formalmente as versões 6, 7 e 8 do UUID. A versão 6 reordena os campos do v1 para ordenabilidade. A versão 7 usa um timestamp Unix de 48 bits em milissegundos mais dados aleatórios, tornando-a a versão recomendada para novos UUIDs baseados em tempo. A versão 8 fornece um formato para UUIDs personalizados e específicos de implementação. A RFC 9562 também deprecia formalmente o v1 em favor do v6/v7.

Boas Práticas

Escolha a Versão Certa

Use v4 para identificadores únicos de uso geral onde não é necessária ordenação nem determinismo. Use v7 para chaves primárias de banco de dados — sua propriedade de ordenação temporal oferece desempenho de índice significativamente melhor. Use v5 quando precisar de IDs determinísticos derivados de nomes (prefira v5 ao v3 para hashing mais robusto).

Use UUID v7 para Chaves Primárias de Banco de Dados

A estrutura ordenada por tempo do UUID v7 mantém as inserções em B-tree sequenciais, reduzindo a fragmentação de índice em aproximadamente 90% comparado a UUIDs v4 aleatórios. Isso se traduz em escritas mais rápidas, índices menores e melhor utilização de cache. A maioria dos bancos de dados modernos (PostgreSQL 17+, MySQL 8.0+) tem suporte nativo a UUID otimizado para este padrão.

Nunca Use UUIDs como Tokens de Segurança

UUIDs são projetados para unicidade, não para sigilo. UUID v1 vaza o timestamp de geração e o endereço MAC. UUID v4 tem apenas 122 bits de entropia com uma estrutura previsível. Para tokens de segurança, chaves de API ou segredos de sessão, use um CSPRNG dedicado para gerar 128 ou 256 bits de dados puramente aleatórios sem a sobrecarga da estrutura UUID.

Valide Antes de Processar

Sempre valide o formato do UUID com uma expressão regular antes de processar ou armazenar. Rejeite entradas malformadas nas fronteiras do sistema — endpoints de API, envios de formulários e entradas de banco de dados. Isso previne ataques de injeção, corrupção de dados e erros difíceis de depurar causados por identificadores inválidos propagando pelo seu sistema.

Perguntas Frequentes