Spring Boot 3 버전에서 Swagger UI 접속 시 404 에러가 발생할 때

 

듣고 있는 강의에서 Swagger UI를 사용하기 위해서 의존성 설치를 하고 접속했는데,

 

 

이런식으로 404 에러가 나고 있었다.

분명 Maven Repository에서 Gradle 잘 복사해왔고 gradle도 다시 빌드했는데, 오류가 나다니..

뭔가 이상해서 구글링을 해보았고 Spring 버전에 따라 다르다는 걸 알게 되었다.

 

 

 

 

 

 

 

해결 방법

 

스프링부터 3버전 이상부터 SpringDoc을 사용하기 위해 추가해야하는 의존성이 다르다는 것이다.

 

https://springdoc.org/

OpenAPI 3 Library for spring-boot

 

공식 문서에 보면 이전과 의존성 라이브러리가 다른 걸 확인할 수 있다.

 

Maven

   <dependency>
      <groupId>org.springdoc</groupId>
      <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
      <version>2.8.5</version>
   </dependency>

 

 

Gradle

implementation 'org.springdoc:springdoc-openapi-starter-webmvc-ui:2.0.2'

 

 

 

그래서 의존성 라이브러리를 변경하고 다시 접속해보니

 

 

정상적으로 접근이 잘 되는 걸 확인할 수 있었다.

 

 

 

 

 

 

 

---

사소해보이지만 에러가 나서 조금 당황했었는데, 구글링을 통해 확실히 알아서 다행이다.

만약 나중에 에러가 다시 발생하면 공식 문서를 들여다보는 습관을 가져야겠다.