PROJECT

[Spring] Swagger 트러블 슈팅

grammiboii 2025. 6. 6. 01:42

상황

전역 예외 핸들러 추가 후 swagger에서 500에러 발생

java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.(java.lang.Object)'

Image Image

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(CustomException.class)
    public ResponseEntity<ResponseError> handleCustomException(CustomException e) {
        ResponseError responseError = new ResponseError();
        responseError.setStatus(e.getErrorCode().getHttpStatus().toString());
        responseError.setMessage(e.getMessage());
        return ResponseEntity.status(e.getErrorCode().getHttpStatus()).body(responseError);
    }
}

해결

이것 저것 찾아보고 시도해 봤는데

원인은 정확하게 모르겠다

결론적으로 swagger 버전 변경으로 해결할수있다

java 21

spring 3.4.0 버전 기준

swagger 2.7.0 버전 이상이 작동하는 것 같다

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