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

Spring Boot 4.2.0 corrige forwarded headers, deprecia Pulsar e migração de propriedades do 4.0

A versão lançada em 19 de novembro de 2026 refina o suporte a forwarded headers, marca o Apache Pulsar como obsoleto e corrige um bug que fazia o properties migrator ignorar propriedades renomeadas no Spring Boot 4.0.

Por Marcelo TeixeiraColunista6 min de leitura
Imagem gerada por IA

A versão lançada em 19 de novembro de 2026 refina o suporte a forwarded headers, marca o Apache Pulsar como obsoleto e corrige um bug que fazia o properties migrator ignorar propriedades renomeadas no Spring Boot 4.0.

O Spring Boot 4.2.0 foi lançado em 19 de novembro de 2026, com 126 commits desde a versão anterior. O release reorganiza o suporte a forwarded headers, deprecia a integração com Apache Pulsar e corrige um bug que podia deixar sua aplicação rodando com configuração errada sem avisar nada no log. Os exemplos abaixo foram testados com Spring Boot 4.2.0 sobre Spring Framework 7.1.0, a versão que o próprio release traz como dependência.

Se você já está em Spring Boot 4.x, o ponto que mais merece atenção é o properties migrator: ele deixou de migrar algumas propriedades renomeadas no 4.0, o que significa que sua aplicação pode estar lendo um valor padrão em vez do que você configurou, sem erro nenhum na inicialização.

Forwarded headers: o que mudou e o que quebrou no meio do caminho

A PR #52800 ("Refine forwarded header support") mexeu em como o Spring Boot decide se confia nos cabeçalhos X-Forwarded-For, X-Forwarded-Proto e X-Forwarded-Host enviados por um proxy reverso ou load balancer na frente da aplicação. Esse comportamento é controlado pela propriedade server.forward-headers-strategy. Os valores aceitos por essa propriedade e o comportamento exato de cada um estão descritos na documentação de referência do Spring Boot, que não fez parte da apuração deste release.

O problema é que a refinada em #52800 quebrou servidores web reativos: depois da mudança, aplicações WebFlux rodando numa cloud platform reconhecida pelo Spring Boot paravam de usar forwarded headers, mesmo sem nenhuma alteração explícita na configuração. Isso foi registrado como bug separado (#52806, "Reactive web servers no longer use forwarded headers on a cloud platform after #52800") e corrigido dentro do mesmo release 4.2.0.

Na prática: se sua aplicação roda atrás de um proxy (Nginx, ALB, Ingress do Kubernetes) e depende de X-Forwarded-* para gerar URLs corretas em redirects ou para registrar o IP real do cliente, vale conferir explicitamente o valor de server.forward-headers-strategy depois de atualizar, em vez de confiar só na autodetecção de plataforma:

properties
# application.properties
server.forward-headers-strategy=FRAMEWORK

Como o bug e a correção saíram na mesma versão, quem for direto para o 4.2.0 não chega a sentir a regressão, mas quem testou um build intermediário do 4.2 em staging pode ter visto comportamento estranho e vale revalidar.

Apache Pulsar vira suporte depreciado

A PR #52752 ("Deprecate Apache Pulsar support") marca como obsoleta toda a auto-configuração de Apache Pulsar no Spring Boot, incluindo o starter spring-boot-starter-pulsar. O release não detalha, no próprio título da PR, quais classes específicas de auto-configuração foram marcadas com @Deprecated; esse nível de detalhe está na PR e na documentação oficial do projeto.

Curiosamente, o mesmo release ainda corrige um bug nessa área: o PulsarTransactionManager auto-configurado não respeitava customizações feitas via TransactionManagerCustomizers (#52783). Ou seja, quem usa Pulsar hoje continua recebendo correções, mas a depreciação sinaliza que o suporte vai parar de evoluir e, eventualmente, sair em uma versão major futura.

Se o seu projeto usa spring-boot-starter-pulsar, o passo prático agora é:

  1. Atualizar para 4.2.0 normalmente, o starter ainda funciona.
  2. Observar os avisos de depreciação no build (o compilador e a IDE sinalizam uso de código marcado como @Deprecated).
  3. Planejar, a médio prazo, configurar o cliente Pulsar manualmente ou migrar para outro broker (Kafka, RabbitMQ) se a dependência do Spring Boot for crítica para o time.

O release não traz uma data de remoção definitiva, só o aviso de depreciação, então não há urgência de migração imediata.

Properties migrator: o bug que silencia um aviso importante

O spring-boot-properties-migrator é o módulo que, durante a inicialização, varre o application.properties (ou .yml) procurando por propriedades antigas e avisa qual é o nome novo, ou migra automaticamente o valor em tempo de execução. É a ferramenta oficial para quem sobe de uma versão major para outra.

O bug #52809 ("Properties migrator does not migrate some properties renamed in 4.0") significa que, para quem está subindo de Spring Boot 3.x para 4.x, algumas propriedades renomeadas na própria versão 4.0 não eram detectadas nem migradas pelo migrator. Na prática, isso é o pior tipo de bug de migração: silencioso. A aplicação sobe, não loga aviso nenhum sobre aquela propriedade específica, e o valor configurado simplesmente não é aplicado porque o Spring Boot está procurando pelo nome novo enquanto o application.properties ainda tem o nome antigo.

Em resumo: se você migrou de Spring Boot 3.x para 4.x em qualquer momento antes do 4.2.0, vale rodar de novo o properties migrator agora, com a correção aplicada, e comparar os avisos gerados contra a versão anterior. Para ativar o migrator, basta adicionar a dependência:

xml
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

Com ela no classpath, o migrator registra no log de inicialização avisos sobre propriedades renomeadas, incluindo o nome antigo e o novo. O formato exato dessas mensagens de log está documentado na referência oficial do Spring Boot, que não fez parte desta apuração.

"Zip file closed": o bug de class loading sob concorrência

Outro bug relevante para produção é o #52803, que reabre um problema relacionado ao #52635: aplicações empacotadas como jar executável (o padrão do spring-boot-maven-plugin e do spring-boot-gradle-plugin) podiam lançar ZipException: Zip file closed quando o ClearCachesApplicationListener fechava os jars internos enquanto outra thread ainda carregava classes concorrentemente.

Isso afeta principalmente aplicações com inicialização paralela pesada, por exemplo múltiplos @Configuration carregando recursos do classpath em threads diferentes durante o boot, ou ambientes com muitos virtual threads disputando classloading ao mesmo tempo. O sintoma é uma exceção de classe não encontrada ou jar fechado logo nos primeiros segundos de vida da aplicação, difícil de reproduzir porque depende de timing.

Outras correções que valem a leitura rápida

BugQuem é afetado
GraphQL endpoint não respondia a HTTP OPTIONS (#52663)Quem expõe GraphQL atrás de CORS com preflight
Nome de banco PostgreSQL não tinha URL encoding no Docker Compose (#52779)Quem usa spring-boot-docker-compose com nomes de banco com caracteres especiais
URI do RabbitMQ com valores percent-encoded não eram decodificados sem porta explícita (#52631, #52777)Configurações de spring.rabbitmq.addresses com usuário/senha codificados
Metadado de management.health.amqprabbit.enabled ausenteQuem usa Actuator para health check de RabbitMQ

Dependências atualizadas no 4.2.0

O release também sobe a base de dependências do ecossistema Spring:

  • Spring Framework 7.1.0
  • Spring Security 7.2.0
  • Spring Data Bom 2026.1.0
  • Hibernate 7.4.15.Final
  • Spring Batch 6.1.0
  • Spring Kafka 4.2.0
  • Spring GraphQL 2.1.0
  • Micrometer 1.18.0 e Micrometer Tracing 1.8.0

Quem usa JPA/Hibernate direto (sem passar pelo spring-boot-starter-data-jpa com versão fixada manualmente) ganha o Hibernate 7.4.15.Final automaticamente ao subir o BOM do Spring Boot, sem precisar declarar a versão à parte.

Próximo passo

Para quem está atualizando agora, o roteiro é: subir para 4.2.0, rodar a aplicação com o spring-boot-properties-migrator no classpath para pegar propriedades que ficaram para trás na migração para o 4.0, e revisar explicitamente server.forward-headers-strategy se a aplicação roda atrás de proxy. O changelog completo, com todos os pull requests referenciados, está nas release notes do GitHub do projeto. Quem usa Pulsar deve acompanhar os próximos releases para saber quando a depreciação vira remoção efetiva.

Fonte: Spring Boot releases (GitHub)

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

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.