[Swagger 오류] Swagger Whitelabel Error - 404 Not Found 에러

오늘은 JAVA Spring 으로 Swagger 사용도중 생긴 오류에 대해서 작성해보겠습니다!!

결론부터 말씀 드리자면, swagger 버전을 확인하세요!!!!!!!!!!

1. 발생한 오류
2. 문제 인식
3. 해결 방법

---

✔️ 발생한 오류

swagger를 작성하고 명세서를 보기위해 http://localhost:8080/swagger-ui/index.html 에 접속하였지만,

계속 화이트라벨 에러 페이지가 떴다. 

오류 화면 : 404 not found 에러

 

SwaggerConfig

Swagger Config에서 group 도 잘 맞춰주었고,

application.yml

application yml 파일에서 패키지명도 정확하게 작성하였다. 

 

패키지명과 group 명, 그리고 Swagger 주소가 꼬이진 않았는지 확인해보았지만, 모두 잘 작성하였다.

---

✔️ 문제 인식

그럼에도 오류가 난다면 build.gradle에 dependency를 확인해보자 !!!!!!!

build.gradle

오류를 고치기 전 추가해놓은 swagger dependency 이다. 

처음 Spring 패키지를 만들때, dependency가 내가 짠 코드랑 맞지않은 버전이 자동으로 추가된 것 같다..

---

✔️ 해결 방법

build.gradle

 

1.7 버전의 swagger(빨간줄) 를 삭제하고 2.0.4 버전 swagger(노란줄)를 추가했다.

 

추가 해야하는 dependency : 

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

 

변경하고 난 뒤, 코끼리를 눌러 변경사항을 적용시킨다 !!

그리고 나서 Swagger Config에 가보면 이전 버전의 swagger에서 가지고 왔던 라이브러리에 에러가 뜬것을 확인할 수 있다. 

좌 : 오류 / 우: 새로운 swagger 버전에 맞게 수정

Swagger Config 까지 새로운 버전에 맞게 고쳐주면, 

 

Swagger가 아주아주 잘 뜨는걸 볼 수 있다 😎😎

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