1.0 Problema

Ao desenvolver a aplicação Vacation Manager usando o Spring Boot 4.0.0, o console do H2 não funcionava e ao tentar acessá-lo, apresentava o erro mostrado na Figura 1.

Não satisfeito, busquei entender o motivo da ocorrência desse problema. Visto que em uma aplicação que usava a versão 3 do Spring Boot o console se comportava corretamente. Após pesquisa sobre, encontrei uma postagem no Medium falando a respeito [1]: informando que a causa era a depedência spring-boot-starter-web, usada no desenvolvimento de aplicações web, que atualmente é nomeada de spring-boot-starter-webmvc.

2.0 Solução

Lendo a postagem foram sugeridas algumas soluções para o problema. Como: usar a versão 3 do Spring Boot e configurar o arquivo application.properties corretamente. Sendo assim, considerando que o arquivo estava configurado corretamente e o downgrade do Spring Boot não era uma opção, escolhi a solução apresentada nos comentários do post. Ela sugeriu a adição da dependência Spring Boot H2 Console para a habilitar o console.

2.1 Passo a Passo

1. Adicione o trecho abaixo no arquivo pom.xml se estiver usando Maven:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-h2console</artifactId>
    <version>4.0.1</version>
</dependency>

Por outro lado, se estiver usando Gradle adicione no arquivo build.gradle o trecho abaixo:

implementation("org.springframework.boot:spring-boot-h2console:4.0.1")

2. Por último, execute a aplicação e veja o resultado:

3. Como estava usando o Docker Compose, foi necessário adicionar a seguinte configuração no arquivo application.properties:

spring.h2.console.settings.web-allow-others=true

Permitindo que serviços externos, nesse caso os navegadores, acessassem o Console de H2 (Obs: é importante que em um ambiente de produção o console não seja acessível às aplicações externas, visto que isso pode revelar informações sensíveis sobre sua aplicação [2]).

3.0 Conclusão

Talvez por ser a versão mais recente do Spring Boot essa instabilidade tenha ocorrido. Visto que testei a versão 4.0.1 e a situação não se repetiu, exigindo somente a correta configuração do arquivo application.properties.

Referências

• [1] https://medium.com/@raushan1156/h2-console-not-working-in-spring-boot-4-0-0-7873e20c82d5. Acesso em: 22 de dezembro de 2025.
• [2] https%3A%2F%2Fwww.acunetix.com%2Fvulnerabilities%2Fweb%2Fspring-boot-misconfiguration-h2-console-enabled%2F. Acesso em: 25 de dezembro de 2025.