[Swagger] Spring, Spring Boot 호환되는 버전 정리

springdoc-openapi × Spring Boot 버전 불일치로 Swagger `/api-docs` 가 500을 뿜었던 기록최근 사내 AI 서빙 모놀리식을 Spring Boot 3.x 로 올리면서Swagger-UI(/swagger-ui), OpenAPI JSON(/api-docs) 가 500 Internal Server Error 를 내뿜는 대참사가 있었다.검색하면 흔히 나오는 “순환 참조”‧“Security 설정” 문제와는 달리, 이번엔 버전 호환성이 주범이었다. 1. 증상요청결과`GET /swagger-ui`UI는 뜨지만 “Failed to load API definition” 경고`GET /api-docs` (또는 `/v3/api-docs`)**500 Internal Server Error*..