[Spring boot3] Swagger 500 에러: Failed to load API definition

 

나는 평소와 같이 개발을 하고 있는데••• 어째서인지 swagger가 갑자기 작동을 안하다(?)

정말 어이없게 빨간창이 뜬 스웨거를 보고 조금 당황했지만

오히려 좋아 너란 에러 처음이야

 

이번 프로젝트에서는 내가 커스텀해서 response 값을 출력하려고 해서

여러 새로운 작업을 했기 때문에, 그거 때문에 오류가 난다는걸 직감적으로 느꼈다•••

왜냐면 실행 시 swagger에서는 오류가 발생하지만

포스트맨은 아주 잘 작동하기 때문이다!

 

 

예외처리 파트의 코드들을 이리저리 수정해보다가

원인을 발견했다.

 

@RestConrollerAdvice 어노테이션을 제거하니 작동,,!!!!

하지만 이걸 지울 경우,  에러 핸들러가 작동하지 않아 응답값이 지저분하게 나오기 때문에 커스텀한 의미가 없어진다..

((챗GPT는 이 에러에 대해 물어봐도 잘몰랐다!! 바보 지피티!!))

 

 

구글링 하다보니 spring boot 최신버전에서 충동이 생긴다는 것을 발견

변경 전에는 3.4.1을 사용했는데, 3.3.6 으로 변경하니 잘 작동한다!

// build.gradle
id 'org.springframework.boot' version '3.4.1'

// 아래로 변경

id 'org.springframework.boot' version '3.3.6'

 

 

 

[참고]

https://stackoverflow.com/questions/64473435/controlleradvice-does-not-allow-swagger-ui-to-be-displayed

@ControllerAdvice does not allow Swagger UI to be displayed