Guia para QA
CPF para teste: CPFs válidos e casos de borda
Testar um campo de CPF com um único número válido cobre o caminho feliz e quase nada além disso. Os bugs de produção moram nos outros casos.
790.528.805-65 127.506.184-28 912.752.758-18 530.897.445-46 889.048.682-11
Última atualização: 24 de outubro de 2026.
Resposta curta
Use CPFs matematicamente válidos e fictícios, nunca o CPF de uma pessoa real, e monte uma bateria pequena com casos válidos e inválidos. Os cinco acima saem na hora; para volume, use a ferramenta para gerar CPF aleatório. A tabela abaixo lista os casos de borda que valem um teste cada.
A bateria mínima
Cada linha foi conferida pelo mesmo validador que o site usa, no momento da construção da página.
| CPF | O que testa | Deve ser |
|---|---|---|
| 111.444.777-35 | CPF válido, caso base | Aceito |
| 000.000.001-91 | Zero à esquerda: vira 191 se guardado como número | Aceito |
| 987.654.321-00 | Os dois verificadores são 0 (resto menor que 2) | Aceito |
| 111.444.777-36 | Segundo verificador errado | Rejeitado |
| 111.444.777-45 | Primeiro verificador errado | Rejeitado |
| 111.111.111-11 | Dígitos repetidos: passa no cálculo, mas é rejeitado | Rejeitado |
| 1114447773 | Dez dígitos (faltando um) | Rejeitado |
| 111444777350 | Doze dígitos (sobrando um) | Rejeitado |
| 1114447773A | Letra no meio dos dígitos | Rejeitado |
As armadilhas que mais aparecem
Zero à esquerda
Qualquer CPF cujos primeiros dígitos sejam zero. Se o campo for guardado como número inteiro, 00000000191 vira 191 e a validação falha depois. CPF é identificador, não quantidade: guarde como texto de 11 posições.
Dígito verificador igual a zero
Quando o resto da divisão por 11 é 0 ou 1, o dígito verificador vira 0 em vez de11 − resto. É a regra que mais gente implementa errada, e ela atinge cerca de um terço dos CPFs (em pelo menos um dos dois dígitos). Um teste só com CPFs "bonitos" nunca passa por ela. Veja o passo a passo do cálculo.
Sequências repetidas
000.000.000-00 até 999.999.999-99 passam no módulo 11, e é justamente o que um testador digita primeiro. A convenção é rejeitá-las por uma regra separada. Se o seu sistema aceita, é bug.
Com e sem máscara
O mesmo CPF chega como 111.444.777-35 do navegador e11144477735 da API. Teste os dois formatos, e decida onde normalizar. Oformatador converte listas inteiras entre eles.
Unicidade
Se a coluna tem restrição de unicidade, dados de teste repetidos quebram a carga. O gerador nunca repete um número dentro do mesmo lote. Para abrir a página já configurada, use parâmetros na URL, por exemplo /?uf=SP&qtd=50&pontuacao=0.
Fixo ou aleatório?
Nos testes automatizados, prefira uma lista fixa de CPFs, versionada junto ao código: o teste que falhou hoje precisa falhar igual amanhã. Reserve a geração aleatória para testes de volume e de propriedade (por exemplo, "todo CPF gerado deve ser válido"). As implementações em seis linguagens trazem as duas funções.
Válido não é cadastrado
Se o ambiente de homologação consulta a Receita Federal, um bureau de crédito ou outro serviço externo, um CPF só matematicamente válido vai ser recusado nessa etapa, porque não existe na base. Para esses fluxos, o caminho é o ambiente de sandbox do próprio provedor ou um mock da integração, não um CPF real emprestado. Sobre por que não usar dados reais, leiaLGPD e dados de teste.
FAQ
Perguntas frequentes sobre CPF para teste
- Qual é um CPF válido para usar em teste?
- Um exemplo é 111.444.777-35: ele passa na conta do módulo 11 e no filtro de dígitos repetidos. Os cinco CPFs no topo desta página mudam a cada clique, e o gerador cria até 1000 de uma vez. Lembre que válido não quer dizer cadastrado: o número pode coincidir com o de uma pessoa real, então use-o só em ambiente de teste, nunca em cadastro de verdade. Gerar CPFs válidos.
- Existe um CPF genérico ou oficial para testes?
- A Receita Federal não publica CPFs reservados para teste: qualquer número que passe no módulo 11 serve para validar formato. Para fluxos que consultam um serviço externo, como meios de pagamento, o caminho é o ambiente de sandbox do próprio provedor, que costuma documentar os CPFs de teste que aceita. Para formulários e bancos de homologação, uma lista fixa de CPFs gerados e versionada no repositório cumpre o papel de "CPF genérico".
- Como criar CPFs para teste dentro do meu próprio código?
- Sorteie nove dígitos e calcule os dois verificadores pelo módulo 11, em vez de sortear 11 dígitos e descartar os inválidos: só 1 em cada 100 sequências de 11 dígitos passa na validação, então o descarte desperdiça quase tudo. O cálculo está explicado passo a passo, e as funções de geração e validação prontas estão em seis linguagens. Ver o código pronto.