IT/오류 컬렉터 조르디

[springboot] Swagger 500 error : Failed to load API definition

토끼개발자 조르디 2025. 2. 17. 02:32

Swagger 에서 오류 발생

API 실행시 생길 수 있는 오류들에 대해서 예외처리를 진행하고 있었다.

그리고 하나의 오류 핸들러 파일(GlobalExceptionHandler) 에 커스텀 오류들을 정리해 보다 통합적으로 관리하고 유지보수도 쉽게 하려고 했다. 그런데 모든 설정을 마치고 로컬에서 테스트를 위해 실행을 했는데, 생각도 못한 곳에서 오류가 생겼다.

 

2025-02-17T02:00:44.952+09:00 WARN 94638 --- [careit] [io-8080-exec-10] .m.m.a.ExceptionHandlerExceptionResolver : Resolved [jakarta.servlet.ServletException: Handler dispatch failed: java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.<init>(java.lang.Object)']

 

 

아래의 사진처럼 swagger 접속에 문제가 생긴 것....

swagger 가 살아있어야 프론트엔드 분들이 테스트도 해보고 데이터가 어떻게 응답이 오는지 등 다 확인할 수 있는데,

그렇다고 핸들러를 빼자니 기껏 설정해놨는데 아깝고... 그래서 구글링을 시작했다 ㅋㅋㅋ 🥹👍

 

 

 

Swagger 오류 해결 (일단은...??)

아래 참고 페이지 여러 방법이 있었는데, 버전을 수정하는건 프로젝트 마감이 얼마 남지 않은 현재.. 로금 리스크가 있다는 생각이 들었다.

그래서 그냥 핸들러 파일에서 @RestControllerAdvice 를 주석처리했다....

 

일단은 API 테스트해보고 그러는게 더 중요하기 때문에.

우선은 임시방편(?)으로 해결했다. ㅠㅠ 

 

 


참고 페이지

https://dev-meung.tistory.com/entry/%ED%95%B4%EC%BB%A4%ED%86%A4-HY-THON-%ED%8A%B8%EB%9F%AC%EB%B8%94%EC%8A%88%ED%8C%85-Swagger-500-%EC%97%90%EB%9F%AC-Failed-to-load-API-definition

 

[트러블슈팅] HY-THON - Swagger 500 에러: Failed to load API definition

🐛이슈- 발생한 오류 copy & paste- 오류가 발생한 상황 간략히 설명각자 API를 구현하던 중 팀원분이 [응답 통일 및 에러 핸들러]를 구현해서 PR을 올려주셨다. API 역할 분배할 때 되도록이면 엔티티

dev-meung.tistory.com