[SpringBoot] Swagger UI 접속 시 java.lang.NoSuchMethodError 발생할 경우 대처 방법

Swagger UI를 적용하려고 하거나, SpringBoot 버전을 2.X.X에서 3.X.X로 업데이트 했을 경우에 

java.lang.NoSuchMethodError: 'io.swagger.v3.oas.models.media.Schema io.swagger.v3.oas.models.media.Schema.....

위와 같은 오류가 발생하며 Swagger UI에서는 500번 에러가  발생하는 경우가 있다.

 

이때 Build.gradle 혹은 Pom.xml에서

// 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'

해당 의존성이 제대로 들어가 있는지 확인 후 

implementation 'io.springfox:springfox-boot-starter:3.0.0'

springfox 의존성이 들어가 있다면 해당 의존성을 제거해주면 정상적으로 작동한다.

 

swagger version이 v2에서 v3로 올라가면서 추가해야하는 의존성이 변경되었는데 그 과정에서 충돌이 일어나는 것 같다.