[Spring Boot] springfox 3.0.0 Whitelabel 에러

프로젝트의 버전 정보

plugins {
    id 'java'
    id 'org.springframework.boot' version '3.1.4'
    id 'io.spring.dependency-management' version '1.1.3'
}

group = 'com.example'
version = '0.0.1-SNAPSHOT'

java {
    sourceCompatibility = '17'
}

현재 프로젝트에서 spring boot 3.1.4 버전, Java 17 버전을 사용 중이다.

 

 

 

맞지 않았던 버전(springfox-boot-starter >> 3.0.0)

// https://mvnrepository.com/artifact/io.springfox/springfox-boot-starter
implementation group: 'io.springfox', name: 'springfox-boot-starter', version: '3.0.0'

http://localhost:8080/swagger-ui/

들어가봐도 404에러가 나고 뜨지 않았다.

 

 

구글링을 아무리 해봐도 원인을 찾지 못하다가 stackoverflow 글을 보고 springfox 대신 SpringDoc을 사용했다.

무언가 빌드했을 때 오류가 나면 버전부터 의심해봐야겠다. 

 

https://stackoverflow.com/questions/70178343/springfox-3-0-0-is-not-working-with-spring-boot-2-6-0

Springfox 3.0.0 is not working with Spring Boot 2.6.0

최신 릴리즈에서는 Spring Boot 2.6.0을 지원하는 springdoc 로 이동하는 것이 좋습니다 . 

위의 내용을 참고하여 build.gradle에서 springfox-boot-starter 대신 springdoc을 사용하는 것으로 수정했다.

 

 

 

 

 

 

springdoc으로 바꾸고 문제 해결

// https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-starter-webmvc-ui
implementation group: 'org.springdoc', name: 'springdoc-openapi-starter-webmvc-ui', version: '2.0.2'

 

https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-starter-webmvc-ui/2.0.2

위의 링크를 참고하면 된다.

 

http://localhost:8080/swagger-ui/index.html

위의 주소로 들어가면 정상적으로 swagger를 사용할 수 있다.