Gerador de UUID online: UUID v4, v7 e Minecraft

Verificar um UUID

Gerador de UUID: UUID v4 aleatório, UUID v7 (GUID) e UUID offline do Minecraft

Escolha a versão, clique no botão e receba um novo UUID, por exemplo 3f2b8c1e-9a4d-4e7b-8c21-5d6f0a9b7e34. Copie-o com um clique e cole no seu código, em um banco de dados, em um arquivo de configuração ou em um teste. Você pode gerar até 1000 UUIDs de uma vez, escrevê-los em maiúsculas, sem hifens ou entre chaves e verificar a versão de qualquer UUID que colar. O mesmo identificador se chama GUID nos produtos da Microsoft (.NET, SQL Server, Windows), e o formato é o mesmo.

Tudo acontece no seu navegador: os UUIDs são gerados com os números aleatórios seguros do navegador (crypto.getRandomValues), então nada é enviado a um servidor e nada é salvo.

O que é um UUID

UUID significa Universally Unique Identifier (identificador único universal). É um número de 128 bits escrito como 32 dígitos hexadecimais em cinco grupos separados por hifens (8-4-4-4-12, 36 caracteres no total). A ideia é simples: qualquer computador pode criar um identificador sozinho, sem consultar um servidor central ou um banco de dados, e ninguém mais criará o mesmo.

Na versão 4, 122 dos 128 bits são aleatórios. Os outros seis bits são fixos: o primeiro dígito do terceiro grupo é sempre 4 (a versão) e o primeiro dígito do quarto grupo é sempre 8, 9, a ou b (a variante). Você pode verificar qualquer UUID v4 por esses dois lugares.

Dois UUIDs podem ser iguais?

Na teoria sim, na prática não. Existem cerca de 5,3 × 10³⁶ UUIDs v4 diferentes. Para ter 50% de chance de uma repetição, é preciso gerar cerca de 2,7 × 10¹⁸ deles, ou seja, um bilhão de identificadores por segundo durante cerca de 85 anos. Para um projeto, o risco é muito menor que o de um disco quebrar ou de um bug no código. Ainda assim, uma boa prática é manter um índice único na coluna que guarda o UUID.

Onde um UUID é usado

• Chaves primárias em um banco de dados. O cliente ou o serviço cria o ID antes de o registro ser salvo, então não é preciso pedir ao banco de dados o próximo número. É conveniente para vários servidores, shards e aplicativos que funcionam offline. Um UUID também não mostra quantos registros você tem, ao contrário de id=1042.
• Chaves de idempotência. Algumas APIs (de pagamento, por exemplo) aceitam uma chave única no cabeçalho de uma requisição. Se a requisição é enviada duas vezes por causa de um erro de rede, o servidor vê a mesma chave e pode ignorar a repetição.
• IDs de rastreamento e de correlação. Um identificador percorre todos os serviços e linhas de log de uma requisição, para você encontrar a cadeia inteira nos logs.
• Nomes de arquivos e links temporários. Um arquivo enviado e salvo como uuid.jpg não pode sobrescrever outro arquivo, e o nome dele não pode ser adivinhado pelo número do anterior.
• Dados de teste, mocks e migrações. Uma forma rápida de obter um valor único para uma fixture, um usuário ou um evento.

UUID v4 ou UUID v7?

O UUID v7 é uma versão mais nova do padrão RFC 9562 (2024), que substituiu a RFC 4122. Os primeiros 48 bits dele são um timestamp Unix em milissegundos, seguidos dos bits de versão e de bits aleatórios. A RFC 9562 diz que UUIDs ordenados por tempo têm melhor localidade no índice do banco de dados que o UUIDv4: os valores novos ficam perto uns dos outros no índice, e a diferença em relação a inserções aleatórias "pode ser de uma ordem de grandeza ou mais". Se você só precisa de um valor único e a ordem não importa, o v4 basta. Se o UUID é a chave primária de uma tabela grande, considere o v7. O PostgreSQL 18 tem a função uuidv7(). Esta ferramenta gera as duas versões. Um lote de v7 está sempre em ordem crescente, inclusive quando muitos UUIDs são gerados no mesmo milissegundo. Um UUID v7 contém o momento em que foi criado, então não o use onde o horário precisa ficar oculto.

Como gerar um UUID no código

• Java: UUID.randomUUID().toString() de java.util gera um v4.
• JavaScript: crypto.randomUUID() funciona nos navegadores (em uma página segura https) e gera um UUID v4.
• Python: str(uuid.uuid4()) do módulo uuid.
• C#: Guid.NewGuid(). SQL Server: NEWID(). PostgreSQL: gen_random_uuid().

UUID para Minecraft

Os jogadores perguntam muito sobre "UUID do Minecraft" e "UUID offline", e isso é diferente de um aleatório. Em um servidor no modo offline (online-mode=false), o UUID de um jogador é um UUID versão 3 feito a partir do hash MD5 de OfflinePlayer: e do nome do jogador (é assim que a Minecraft Wiki descreve). Escolha "UUID offline do Minecraft" na lista acima, digite os apelidos (um por linha) e receba os UUIDs offline. Por exemplo, Notch gera b50ad385-829d-3141-a216-7e7d7539ba7f. A caixa das letras importa: notch gera outro UUID. Um v4 aleatório não corresponde a nenhum deles.

Bom saber

• Um UUID é um identificador, não um segredo. Não o use como senha nem como única proteção de um link privado. Para senhas use o gerador de senhas.
• As letras podem ser minúsculas ou maiúsculas, e os hifens podem ser omitidos em alguns sistemas. As duas formas significam o mesmo número, mas mantenha um só formato no projeto para que as strings sejam comparadas como iguais.
• Para obter um nome curto de página a partir de um título use o gerador de slug, e para obter a impressão digital de um texto ou arquivo o gerador de hash.