1
resposta

Como utilizar o Spring Doc com o Spring Boot 3

Após seguir o passo a passo mostrado na aula, ao executar o Spring Boot e tentar acessar o Swagger Ui no navegador (em http://www.localhost:8080/swagger-ui/index.html), era exibido a seguinte mensagem de erro:

{"timeStamp":"2025-01-25T18:48:00.164069078","status":500,"error":"INTERNAL_SERVER_ERROR","message":"No static resource swagger-ui/index.html.","path":"/swagger-ui/index.html"}

Ao ler a documentação da API do Spring Doc (em https://springdoc.org/#Introduction), descobri que a dependência springdoc-openapi-ui só podia ser utilizada junto ao Spring Boot 1.x e 2.x. Para versões superiores, era necessário utilizar a dependência springdoc-openapi-starter-webmvc-ui.

Além disso, a versão do Spring Doc deve ser compatível com a versão do Spring Boot. Para isso, existe uma tabela de equivalência entre as versões do Spring Boot e do Spring Doc.

O meu código (para a versão 3.3.2 do Spring Boot) ficou da seguinte forma:

pom.xml:

...
<dependencies>
     ...
     <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
            <version>2.6.0</version>
     </dependency>
 </dependencies>
 ...
1 resposta

Olá Henrique! Tudo bem?

Fico feliz que tenha conseguido resolver essa situação da dependência para a versões inferiores do Spring.

Além disso, agradeço por compartilhar aqui no fórum a solução que você encontrou, tenho certeza que irá ajudar outros alunos que estiverem na mesma situação que você.

No mais, bons estudos!