powered byiMasterstutoriais · referência · código em portuguêsPatrocínio
Java

Hibernate Validator 9.2.0 traz validação de senha e novos constraints de texto

A versão 9.2.0.Final, lançada em 20 de novembro de 2026, adiciona constraints prontos para força de senha, vazamento de dados e textos, além de uma API de bean resolution para injetar serviços da aplicação direto nos validators.

Por Marcelo TeixeiraColunista5 min de leitura
Imagem gerada por IA

O time do Hibernate liberou em 20 de novembro de 2026 a versão 9.2.0.Final do Hibernate Validator, a implementação de referência da especificação Bean Validation (Jakarta Validation). A novidade que mais interessa a quem mantém formulário de cadastro é a validação de senha nativa: três constraints novos cobrem força, vazamento em bases de dados públicas e política composta de regras. Os exemplos abaixo usam a dependência org.hibernate.validator:hibernate-validator:9.2.0.Final no Maven; o projeto passou a exigir também o artefato org.hibernate.accessor:hibernate-accessor quando você gerencia o classpath manualmente, sem um gerenciador de dependências transitivas.

Três constraints novos para senha

@PasswordStrength, @NotCompromised e @PasswordPolicy aceitam CharSequence ou char[] e tratam null como válido: se o campo for obrigatório, combine com @NotBlank ou @NotNull. A ideia é que você plugue sua própria biblioteca de estimativa de força e sua própria fonte de dados de vazamento, em vez de o Hibernate Validator embutir uma:

java
import jakarta.validation.constraints.NotBlank;
import org.hibernate.validator.constraints.NotCompromised;
import org.hibernate.validator.constraints.PasswordStrength;

class RegistrationForm {
 @NotBlank
 @PasswordStrength(min = 3)
 @NotCompromised
 private String password;
}

O min = 3 depende da escala do estimador escolhido; com a biblioteca com.nulabinc.zxcvbn (que usa escala de 0 a 4), isso exige a parte superior da pontuação. Você registra os serviços via uma API de bean resolution nova, chamando addBeanConfigurer na construção do ValidatorFactory:

java
import jakarta.validation.Validation;
import jakarta.validation.ValidatorFactory;
import org.hibernate.validator.HibernateValidator;
import org.hibernate.validator.bean.BeanReference;
import org.hibernate.validator.spi.password.CompromisedPasswordChecker;
import org.hibernate.validator.spi.password.PasswordStrengthEstimator;

ValidatorFactory createValidatorFactory(CompromisedPasswordChecker breachChecker) {
 return Validation.byProvider(HibernateValidator.class)
 .configure()
 .addBeanConfigurer(context -> {
 context.define(PasswordStrengthEstimator.class,
 BeanReference.ofInstance(new ZxcvbnPasswordStrengthEstimator()));
 context.define(CompromisedPasswordChecker.class,
 BeanReference.ofInstance(breachChecker));
 })
 .buildValidatorFactory();
}

A documentação oficial deixa claro o ponto que mais importa em produção: nunca logar a senha nem incluí-la nas mensagens de violação, nunca mandar a senha em texto puro ou o hash completo para um serviço externo de checagem de vazamento, e limpar o char[] assim que ele não for mais necessário (uma String não dá para limpar da memória, por isso a API aceita char[]). Se o seu serviço de checagem de vazamento faz chamada de rede, trate timeout e falha: um serviço externo fora do ar não pode travar o cadastro do usuário.

Políticas de senha compostas

Quando a regra de senha da empresa tem várias exigências (tamanho mínimo, caractere maiúsculo, dígito, sem espaço), o @PasswordPolicy evita empilhar vários constraints soltos. Você implementa PasswordPolicyDefinition uma vez e aplica em qualquer campo:

java
import jakarta.validation.constraints.NotNull;
import org.hibernate.validator.constraints.PasswordPolicy;
import org.hibernate.validator.constraintvalidation.HibernateConstraintValidatorInitializationContext;
import org.hibernate.validator.spi.password.CharacterType;
import org.hibernate.validator.spi.password.PasswordPolicyBuilder;
import org.hibernate.validator.spi.password.PasswordPolicyDefinition;

public class AccountPasswordPolicy implements PasswordPolicyDefinition {
 @Override
 public void configure(PasswordPolicyBuilder builder,
 HibernateConstraintValidatorInitializationContext context) {
 builder.minLength(12)
 .requireCharacters(CharacterType.UPPERCASE, 1)
 .requireCharacters(CharacterType.DIGIT, 1)
 .noWhitespace();
 }
}

class Account {
 @NotNull
 @PasswordPolicy(AccountPasswordPolicy.class)
 private char[] password;
}

Uma pegadinha boa de saber: cada regra que falha gera sua própria violação. Uma senha curta sem maiúscula e sem dígito retorna três mensagens de erro, não uma genérica dizendo "senha inválida" (isso muda o formato da resposta de erro que você devolve no front-end, então vale revisar o tratamento de ConstraintViolationException se você hoje pega só a primeira violação).

Constraints de texto que resolvem casos comuns

A versão também adiciona uma leva de constraints de texto que antes exigiam @Pattern com regex manual. @Contains verifica substring, com minRequired para exigir um mínimo de ocorrências em vez de todas; @DateTimeFormat valida string de data usando padrão de DateTimeFormatter, inclusive com nome de mês localizado:

java
class Submission {
 @Contains(value = {"Hibernate", "Jakarta"}, minRequired = 1, ignoreCase = true)
 String description;

 @DateTimeFormat(pattern = "dd MMMM uuuu", locale = {"en-US", "fr-FR"})
 String publicationDate;
}

Completam a lista: @Alphabetic, @Alphanumeric, @Numeric (aceita dígito fora do ASCII), @Encoding (útil antes de exportar texto para um sistema que só aceita US-ASCII), @StartsWith/@EndsWith, @UpperCase/@LowerCase, @Trimmed (mesma definição de espaço do String.strip()) e @Hexadecimal. Para valor opcional, @NullOrNotBlank e @NullOrNotEmpty resolvem o caso em que Optional vazio é válido, mas presente-e-vazio não é:

java
class Profile {
 Optional<@NullOrNotBlank String> displayName;
 Optional<@NullOrNotEmpty List<String>> interests;
}

RENAVAM, CPF e os documentos brasileiros

O lançamento adiciona uma leva de validadores de documento regional: @IBAN, @BIC, @ISSN, @CUIT e @CUIL (Argentina), @RUC (Paraguai) e, direto de interesse para quem desenvolve no Brasil, @RENAVAM, que valida número de registro de veículo nas representações atual e legada. Quanto ao @CPF, a nota de migração do próprio projeto avisa que a formatação aceita por esse constraint mudou nesta série, então quem atualiza de 9.1 para 9.2 precisa revisar os testes desse constraint antes de subir para produção, não só os de senha.

Bean resolution, acesso a propriedade e o que mais mudou

A API de bean resolution (BeanConfigurer, getBeanResolver()) não serve só para senha: qualquer ConstraintValidator customizado pode resolver um serviço da aplicação pelo tipo, e o módulo hibernate-validator-cdi já oferece um provider para quem usa CDI. Framework de DI próprio também pode implementar um BeanProvider.

Outra mudança estrutural é a dependência nova hibernate-accessor, que agora resolve o acesso a propriedade do bean durante a validação. Em JDK 24 ou mais recente, o padrão é gerar o acessor via Class-File API; em JDK anterior, cai para reflection. Dá para forçar um factory específico, inclusive ASM ou ByteBuddy, se o seu projeto já depende de um deles.

Na lista de correções, três itens afetam quem usa validação programática ou expressões: HV-2291 inclui automaticamente tipos com mapeamento programático no validator factory de escopo pré-definido; HV-2280 resolve getter mapeado programaticamente respeitando a estratégia de seleção de getter do factory; HV-2283 dá suporte a acessar componente de record em expressões Jakarta EL dentro de mensagem de validação, útil para quem já migrou DTO de classe para record e queria interpolar um campo dele na mensagem de erro.

O que fica em aberto

O próprio anúncio do Hibernate avisa que boa parte dos constraints e pontos de extensão novos está marcada como incubating: a API pode mudar em versão menor antes de estabilizar, então não é prudente travar a assinatura de PasswordPolicyBuilder ou BeanResolver num contrato público da sua própria aplicação ainda.

Quem está em 9.1 e quer migrar deve ler o guia de migração oficial antes: ele cobre, além da formatação do @CPF, mudança em PropertyNodeNameProvider, validação de property path em validateProperty()/validateValue() mesmo sem constraint no bean, composição de constraint embutido e escaping de parâmetro de mensagem. Para tirar dúvida de uso, o canal oficial é a tag hibernate-validator no Stack Overflow e o fórum de usuários do projeto; para sugestão de constraint ou bug, o issue tracker no GitHub.

Fonte: Hibernate Blog

PatrocínioContinue estudando JavaTrilhas completas, projetos e exercícios na DevMedia.Travou em algum passo?Pergunte no Fórum iMastersPoste o trecho de código e o erro: a comunidade responde.Notícias da stackO que saiu de novo, no iMastersLançamentos, versões e eventos do ecossistema dev.

Este artigo foi escrito por Marcelo Teixeira. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.

Marcelo Teixeira

Editor virtual de Java do Linha de Código. Cobre Java moderno (records, pattern matching, virtual threads), Spring Boot, JPA e Hibernate, Maven e Gradle, e o Kotlin quando ele conversa com a JVM. Escreve para quem mantém o monólito da empresa e para quem está aprendendo a primeira linguagem tipada, sempre declarando a versão do JDK e do framework.

Mais de Marcelo Teixeira

Próximos passoso que estudar a partir daqui

  1. você está aquiHibernate Validator 9.2.0 traz validação de senha e novos constraints de texto
  2. mesmo autorSpring Boot 4.2.0 corrige forwarded headers, deprecia Pulsar e migração de propriedades do 4.0Java · 1 min

Newsletter

Os melhores tutoriais da semana, no seu e-mail

Toda semana, os tutoriais novos das sete stacks e o guia de referência que vale guardar. Gratuita, sem spam.