Como funciona o gerador de CPF
Um número de CPF (Cadastro de Pessoas Físicas) tem 11 dígitos: 9 dígitos base e 2 dígitos verificadores, calculados a partir dos 9 primeiros usando um algoritmo público de módulo 11. Este gerador sorteia os 9 primeiros dígitos e calcula os dígitos verificadores exatamente como a Receita Federal faz, garantindo que o resultado seja um CPF matematicamente válido.
Você pode escolher a região fiscal (o 9º dígito) para simular CPFs emitidos em um estado específico, e gerar vários números de uma vez — útil para popular bancos de dados de teste ou validar formulários de cadastro.
Para que serve gerar um CPF
Times de desenvolvimento usam CPFs de teste para validar formulários, testar integrações com sistemas de pagamento e simular cadastros sem usar dados de pessoas reais. Como os números são aleatórios, eles não pertencem a ninguém — use-os exclusivamente para fins de teste e desenvolvimento.
Por que não usar CPFs reais em ambiente de teste
A prática de copiar a base de produção para homologação continua comum e é justamente o que a LGPD desencoraja. CPF é dado pessoal, e ambientes de teste têm, quase sempre, controle de acesso mais permissivo, logs mais verbosos, dumps circulando por máquinas de desenvolvedores e backups com proteção menor. Cada cópia multiplica a superfície de exposição sem que exista finalidade legítima para tratar aquele dado ali.
Dados sintéticos resolvem o problema na origem: se o número não pertence a ninguém, não há titular a ser notificado em caso de incidente, não há base legal a justificar e não há retenção a controlar. É por isso que gerar massa de teste costuma ser mais simples do que anonimizar a base real — anonimização mal feita frequentemente permite reidentificação por cruzamento com outros campos.
Montando uma massa de teste
Alguns pontos que costumam aparecer ao popular um banco de dados de homologação:
- Unicidade. Os números são sorteados de forma independente a cada geração, então duplicatas são possíveis. Para uma coluna com índice único, gere um lote maior que o necessário e deduplique antes de inserir.
- Formato de armazenamento. Guarde apenas os 11 dígitos, sem pontuação, e em coluna de texto — colunas numéricas descartam o zero à esquerda de CPFs que começam com 0, corrompendo o dado silenciosamente.
- Casos negativos. Uma suíte de testes completa precisa também de entradas inválidas: dígito verificador errado, tamanho incorreto, sequências repetidas, campos com letras. Validar o caminho feliz não prova que a rejeição funciona.
- Distribuição regional. Se o sistema tem alguma lógica por região fiscal, gere lotes com o 9º dígito variado em vez de sempre o mesmo.
Para uma massa mais completa, com nome, endereço e outros campos coerentes entre si, o gerador de pessoa fake monta o registro inteiro. Para conferir números que você já tem, o validador de CPF refaz o cálculo do dígito verificador.
O que este gerador não faz
Ele não consulta a Receita Federal e não tem como saber se um número sorteado coincide com um CPF efetivamente emitido. O espaço de combinações é grande o bastante para que isso seja improvável em um número específico, mas não é impossível — o que reforça que esses números servem para testar sistemas, nunca para representar uma pessoa.
Também não gera CPF "de uma pessoa" nem descobre o CPF de alguém a partir de nome ou data de nascimento. Não existe função pública que faça isso, e serviços que prometem esse tipo de busca operam à margem da lei.