<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Validação de dados em backend: o guia definitivo

DA

10 min

Validação de dados em backend: o guia definitivo

Guia definitivo de validação de dados em backend: camadas, diferença entre validar e sanitizar, formato de erro, caso do CNPJ alfanumérico e curso gratuito em 26/10.

Neste artigo

Validação de dados é a fronteira do backend. Tudo que chega de fora, seja de formulário, aplicativo ou integração, é dado não confiável até prova em contrário, e o servidor é o último ponto em que dá para barrar problema antes que ele vire registro errado, falha de segurança ou dor de cabeça no suporte. Quem trata validação como detalhe de tela descobre o custo no banco, no log e no chamado do cliente.

Este guia percorre o assunto do começo ao fim: o que validar, onde validar, como devolver erro, o que fazer com dado que passa e o caso real do CNPJ alfanumérico, que entra em vigor no Brasil e vai aparecer em formulário de meio mundo. A Samsung Ocean abre o curso gratuito Validação de Dados em Backend em 26/10, às 09:00, presencial no campus Manaus, e este guia serve de preparação e de referência para depois da aula.

Por que validar no servidor é obrigatório

Validação no navegador é conveniência, nunca garantia. Qualquer pessoa com ferramenta de desenvolvedor aberta altera, remove ou simplesmente ignora a verificação da tela. O servidor é o único ponto em que a regra vale de verdade, porque é lá que o dado vira registro, dispara cobrança, gera notificação e alimenta relatório.

A lista do que acontece sem validação no servidor é conhecida: campo obrigatório que chega vazio e quebra a consulta, número que chega como texto e estoura a conta, texto gigante que estoura o limite do banco, valor fora da faixa que passa pela regra de negócio, e conteúdo malicioso que segue para outra camada. Nenhum desses casos exige ataque sofisticado; basta um formulário mal preenchido ou um script esquecido apontado para a sua API.

Existe ainda o motivo menos comentado: validação é documentação viva do domínio. Quando as regras de entrada estão explícitas, qualquer pessoa do time entende o que o sistema aceita e o que rejeita. O sistema deixa de depender do conhecimento de quem escreveu a primeira versão. Para reforçar a base de contrato, os fundamentos de API explicados do zero cobrem o vocabulário de requisição, resposta e status que a validação usa.

Validar, sanitizar e formatar são coisas diferentes

Os três termos aparecem misturados e fazem coisas distintas. Validar é decidir se o dado atende à regra e rejeitar quando não atende. Sanitizar é ajustar o dado antes de usar, como remover espaço extra ou normalizar acentuação, sem mudar o significado. Formatar é apresentar o dado de um jeito específico, como máscara de telefone ou de documento.

A confusão mais perigosa é usar sanitização no lugar de validação. Limpar o dado e seguir em frente esconde entrada inválida, em vez de informar o problema a quem enviou. O caminho correto é validar primeiro, rejeitar com mensagem clara quando a regra não for atendida e só então normalizar o que passou, para gravar de forma consistente. Formatação, por sua vez, pertence à apresentação, e não ao armazenamento.

ℹ️ Info: gravar o dado sempre no mesmo formato, como telefone só com dígitos e documento sem pontuação, simplifica busca, comparação e deduplicação. A máscara fica na tela, onde pertence.

As camadas da validação

Validação profissional acontece em camadas, e cada uma tem um papel. A primeira é a de formato, que verifica tipo, tamanho, obrigatoriedade e padrão. A segunda é a de coerência, que checa combinação entre campos, como data final maior que a inicial ou estado compatível com o país informado. A terceira é a de regra de negócio, que consulta o estado do sistema, como verificar se o documento já está cadastrado ou se o limite do plano foi atingido.

Separar as camadas tem efeito prático na mensagem de erro e no teste. Formato inválido gera erro de campo, que a tela destaca. Coerência inválida gera erro de formulário, que a pessoa corrige ajustando dois campos. Regra de negócio gera erro de operação, que não depende de digitação e pede outra ação. Misturar tudo em um bloco único transforma qualquer problema em mensagem genérica.

O que validar: tipo, formato, faixa e tamanho

Toda entrada merece quatro perguntas. O dado é do tipo esperado? O formato corresponde ao que o campo promete? O valor está dentro da faixa aceitável? O tamanho cabe no que o sistema suporta? Responder essas quatro perguntas cobre a maior parte dos problemas que chegam ao banco.

Vale detalhar dois casos que escapam da checagem ingênua. Número precisa de faixa, porque preço negativo e quantidade absurda são tão inválidos quanto texto. Data precisa de limite razoável, porque data no passado distante ou no futuro remoto quase sempre indica erro de digitação. E todo campo de texto precisa de limite de tamanho, independentemente do que a interface sugere, porque a interface não é o único cliente da API. O guia de PostgreSQL para desenvolvedores ajuda a alinhar validação e tipo da coluna, evitando divergência entre o que o código aceita e o que o banco suporta.

Como devolver o erro de validação

Erro de validação é informação, não castigo. O consumidor precisa saber qual campo falhou, por que falhou e o que fazer para corrigir. Mensagem genérica como dado inválido obriga tentativa e erro e aumenta o abandono em formulário longo, além de empurrar trabalho para o suporte.

Um bom retorno de validação segue três regras. Primeira: status adequado, indicando que o problema está na requisição. Segunda: lista de campos com motivo objetivo, no idioma de quem consome e sem jargão interno. Terceira: nada de detalhe de infraestrutura, como nome de tabela ou rastro de pilha, que ajuda atacante e confunde usuário. Erro bom corrige o dado; erro ruim gera chamado.

Um caso real: o CNPJ alfanumérico

O CNPJ alfanumérico é o exemplo perfeito de por que validação precisa acompanhar o mundo. O identificador deixa de ter apenas números e passa a aceitar letras em parte das posições, mantendo o mesmo tamanho e a mesma regra de dígito verificador, com um cálculo ajustado para o novo alfabeto. Formulário e API que assumem apenas dígitos vão rejeitar documento válido quando o formato novo começar a circular.

O impacto prático alcança cadastro de fornecedor, emissão de nota, integração contábil e qualquer rotina que valide o documento. A referência de como o CNPJ alfanumérico muda o cadastro em 2026 explica a mudança, e o caminho para consultar dados de empresas com API gratuita de consulta de CNPJ mostra o uso real em backend. Quem projeta a validação com expressão regular amarrada ao formato antigo precisa revisar antes que o primeiro caso apareça em produção.

O ensinamento geral fica maior que o documento: regra de validação é código com data de validade. Centralizar a regra em um único ponto do sistema, com teste que cobre os casos válidos e inválidos, evita ter cinco versões diferentes da mesma checagem espalhadas pelo projeto.

Padrões de schema e bibliotecas

Escrever validação campo por campo na mão funciona em projeto pequeno e vira duplicação em projeto grande. Por isso o mercado consolidou a ideia de schema: a regra de cada entrada fica declarada em um só lugar, e a mesma declaração serve para validar, documentar e gerar teste. Cada linguagem tem biblioteca madura para essa tarefa, e o roadmap de backend recomenda escolher uma e usar de forma consistente.

Além da biblioteca, vale adotar três hábitos. Declarar o schema por operação, porque criar e atualizar costumam ter regras diferentes. Reaproveitar regra comum entre campos, como documento e telefone, em vez de copiar. E manter o teste do schema junto do código, cobrindo pelo menos um caso válido e um inválido por regra. Segurança e validação caminham juntas, como mostram as análises de ataques à cadeia de suprimentos e o que o código pode fazer, em que a entrada mal checada é quase sempre a porta de entrada.

O curso gratuito da Samsung Ocean

O curso Validação de Dados em Backend acontece em 26/10, às 09:00, com uma aula presencial no campus Manaus e inscrições abertas na página oficial. A ficha resume o que está confirmado:

CampoInformação
CursoValidação de Dados em Backend
Data de início26/10 às 09:00
Duração1 aula, término em 26/10
ModalidadePresencial, campus Manaus, inscrições abertas
CustoGratuito, com certificado da Samsung Ocean
InscriçãoPágina oficial da atividade na Samsung Ocean

A aula é gratuita e presencial, com inscrição pela página oficial da atividade. Para aproveitar, chegue com um caso real em mente: um formulário do seu projeto, com os campos e as regras que ele deveria ter. Em laboratório presencial, quem traz problema concreto sai com solução aplicada, e não só com anotação de teoria. Garanta sua vaga no curso Validação de Dados em Backend e leve o formulário escolhido.

Perguntas frequentes

Qual a diferença entre validar e sanitizar dados?

Validar é decidir se o dado atende à regra e rejeitar quando não atende; sanitizar é ajustar o dado, como remover espaço extra, sem mudar o significado. Primeiro se valida, depois se normaliza o que passou. Usar sanitização no lugar da validação esconde entrada inválida em vez de avisar quem enviou.

Validar no frontend não é suficiente?

Não. A validação do navegador é conveniência para o usuário e pode ser removida ou ignorada por qualquer cliente. O servidor é o único ponto em que a regra vale para todo mundo, inclusive para integrações e scripts que nunca passam pela tela.

Onde colocar a validação no código?

Na fronteira da aplicação, antes da regra de negócio, em camadas: formato, coerência entre campos e regra de negócio. A declaração deve ficar centralizada, de preferência em schema por operação, para não espalhar a mesma checagem em vários pontos do projeto.

Como o CNPJ alfanumérico afeta a validação?

O identificador passa a aceitar letras em parte das posições, mantendo tamanho e dígito verificador com cálculo ajustado. Sistemas que só aceitam dígitos precisam revisar formulário, API e rotina de integração para não rejeitar documento válido no formato novo.

O curso de validação de dados da Samsung Ocean é gratuito?

Sim. A atividade é gratuita, presencial no campus Manaus, marcada para 26/10 às 09:00, com uma aula e inscrições abertas na página oficial. Os cursos da Ocean são gratuitos e emitem certificado.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Atualizado em 06/10/2026 •

Ver perfil do autor

COMPARTILHAR