NOT FOUND

Unable to render this definition Spring boot Swagger error exception handler 본문

spring boot

Unable to render this definition Spring boot Swagger error exception handler

이종은 2025. 2. 19. 17:13

에러 문구

Unable to render this definition

The provided definition does not specify a valid version field.

Please indicate a valid Swagger or OpenAPI version field. Supported version fields are swagger: "2.0" and those that match openapi: 3.0.n (for example, openapi: 3.0.0).

 

에러 사진

 

에러 원인

우선 저는 @RestControllerAdvice와 @ExceptionHandler 때문이었습니다.

다른 원인일 경우도 있는데

http://localhost:8080/v3/api-docs

해당 URL에 접속했을 때 자신이 설정한 에러가 나온다면 exception handler때문일 확률이 매우 큽니다.

 

우선 예외를 출력해봤습니다.

Handler dispatch failed: java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.<init>(java.lang.Object)'
java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.<init>(java.lang.Object)'

 

에러 해결

springdoc:
  api-docs:
    enabled: true
  swagger-ui:
    path: /swagger-ui.html
  override-with-generic-response: false

.yml 파일에 override-with-generic-response: false 를 추가하면 해결됩니다.

 

해당 속성에 대한 설명입니다. When true, automatically adds @ControllerAdvice responses to all the generated responses.

 

즉 true일 경우 모든 응답에 @ControlerAdvice 응답을 추가하는 속성인 것입니다. 

기본값이 true이기때문에 false로 바꾸어주시면 해결됩니다.

저작자표시 (새창열림)

'spring boot' 카테고리의 다른 글

Exception: Type definition error: [simple type, class org.hibernate.proxy.pojo.bytebuddy.ByteBuddyInterceptor]  (0) 2025.03.28
Error creating bean with name 'org.springframework.security.config.annotation.web.configuration.WebSecurityConfiguration': Injection of autowired dependencies failed  (0) 2025.02.24
개발 환경 Swagger CORS 에러  (0) 2024.12.07
response because it is invalid java.lang.IllegalArgumentException: The Unicode character  (0) 2024.08.08
null일 수 있는 값과 equals (Cannot invoke \"String.equals(Object)\)  (0) 2024.04.25
'spring boot' Related Articles more