[Swagger] Failed to load API definition

Kwon·2025년 9월 18일

스프링부트

목록 보기
12/12

에러 내용

  • 스웨거로 스프링부트 테스트 도중, 해당 에러가 발생

    Fetch error
    response status is 500 /v3/api-docs

원인

  1. 구글에 검색해보니 HandlerException 내에 존재한 @RestControllerAdvice 를 주석처리 해야 가능하다고 함
@Slf4j
@RestControllerAdvice
public class ExceptionController {

하지만 안됨

  1. 스웨거 버전을 맞춰야 한다고도 나왔지만 그 마저도 안됨

해결

@Schema(description = "")
private String orderKind;
  • DTO에서 스키마 어노테이션의 description 부분을 채우지 않아 생겼던 문제인 걸 발견
  • 해당 부분을 채워주니 잘 해결됨
profile
📲 @bu_kwon_2 / 💻 dnu05043.log / ⌨ Back-end / 🦁 LikeLion

0개의 댓글