[SPRING] Spring Boot 3.0 + Springdoc(Swagger3) 404에러

기존 Spring Boot 2.5.7에서 따끈따끈한 3.0버전으로 마이그레이션 하는 중 openapi에서 발생한 에러사항에 대해 

정리합니다. 

---

Swagger-ui 403, 404 발생!

---

Spring Boot 3.0으로 마이그레이션을 끝내고 테스트를 하는중 Swagger-ui 페이지가 404, 403 에러코드를 뱉으며 접속되지 않는 현상이 발생했습니다. 

 

처음엔 403에러가 발생했었고 3.0으로 마이그레이션하면서 Spring Security 설정방법도 많이 변경됐기 때문에 Security설정을 잘못하여 발생한 것으로 생각하였지만 테스트 결과 Security의 문제가 아니였습니다. 

 

결론은 허무하게도 Spring Boot 3.0과 사용중인 open-api(Swagger) 버전이 호환이 안되어 발생한 것으로 

확인했습니다. 

 

Springdoc 공식 홈페이지를 가보면 쉽게 해당사항을 확인할 수 있습니다. 

Spring-boot v3, Swagger-ui

 

공식 홈페이지에서 반영 방법을 확인하여 의존성 변경했고 Swagger-ui페이지 정상적 접근 확인 했습니다. 

openapi 의존성 변경

공식 홈페이지에 1.x버전, SpringFox에서의 마이그레이션에 대해 설명되어 있으니 해당 문제가 발생하신 분들은 참고하시면 좋을것같습니다.