Gerador de UUID

Como usar o Gerador de UUID

1. 1Escolha o formato. Maiúsculas ou minúsculas, com ou sem hífens.
2. 2Clique em "Gerar UUID". Para gerar vários de uma vez, mude a quantidade antes de clicar.

O que é um UUID e por que a versão 4 é a mais usada

UUID (Universally Unique Identifier) é um identificador de 128 bits, normalmente representado como 32 caracteres hexadecimais divididos em 5 grupos por hífen (8-4-4-4-12), como 550e8400-e29b-41d4-a716-446655440000. Existem várias versões da especificação, cada uma com uma forma diferente de gerar o identificador: a versão 1 deriva do horário e do endereço MAC da máquina, a versão 5 deriva de um hash de nome, e a versão 4, a mais usada no dia a dia, é gerada inteiramente por números aleatórios. Com espaço suficiente para mais de 5 undecilhões de combinações possíveis, a chance de dois UUIDs v4 gerados aleatoriamente colidirem é, na prática, irrelevante para a esmagadora maioria dos sistemas.

Em teste de software, UUID aparece o tempo todo como chave primária de registros de teste, identificador de sessão, nome de arquivo temporário ou correlação de requisições em log — qualquer situação em que você precisa de um valor único, sem coordenar com nenhum banco de dados central para garantir que não vai repetir.

Exemplo de código: geração de UUID v4 no navegador

// Disponível nativamente em todo navegador moderno, sem biblioteca externa
const id = crypto.randomUUID();
console.log(id);
// -> "550e8400-e29b-41d4-a716-446655440000"

Antes da função crypto.randomUUID() existir nativamente, gerar um UUID v4 no navegador exigia montar manualmente a string a partir de Math.random(), com mais chance de erro na hora de fixar os bits de versão e variante exigidos pela especificação. Como essa API usa o gerador de números criptograficamente seguro do navegador por baixo dos panos, o resultado já sai no formato correto e estatisticamente mais robusto do que uma implementação caseira baseada em Math.random().

Onde um UUID entra na rotina de QA e desenvolvimento

Em massa de teste, é comum precisar de identificadores únicos que não dependem de nenhum banco de dados para garantir que não vão colidir com um registro já existente. Alguns cenários onde vale usar o gerador em lote em vez de gerar um valor por vez:

• Popular uma fixture de teste automatizado com N registros distintos, exportando o lote como JSON e colando direto no arquivo de massa de dados.
• Simular chaves de idempotência em testes de API, garantindo que cada requisição de um cenário de carga use um identificador diferente.
• Nomear arquivos temporários gerados durante uma suíte de testes de upload, evitando conflito quando os testes rodam em paralelo.
• Criar um correlation-id de exemplo para testar se um sistema de logs está de fato propagando o identificador entre serviços.

Vale lembrar que UUID não é a única forma de gerar identificador único — bancos de dados relacionais tradicionalmente usam contadores incrementais (auto increment), e alguns sistemas distribuídos preferem formatos ordenáveis por tempo, como ULID. A vantagem do UUID v4 é justamente não depender de nenhuma coordenação central: qualquer máquina, offline, pode gerar um valor com colisão praticamente impossível, o que o torna prático tanto para dados de produção quanto para massa de teste.

Perguntas Frequentes