Spring Boot - Swagger(3.0.0) 적용 시 발생하는 오류 원인과 해결 방법

Spring Boot(2.7.7)에 Swagger(3.0.0)을 적용하면서 발생했던 에러다.

Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException

원인

Spring Boot 2.6 버전부터 Spring MVC 핸들러 매핑에 대해 요청 경로를 일치시키는 기본 전략이 AntPathMatcher에서 PathPatternParser로 변경되었다고 한다.

이 때문에 몇몇 라이브러리에서 오류가 발생하는데 그 중 하나가 Swagger다. 우리는 이 전략을 기존의 AntPathMatcher로 변경해주어야 한다.

해결

application.yml에 속성을 아래와 같이 추가해주어 요청 경로 일치 전략을 AntPathMatcher로 변경해준다.

spring:
	 mvc:
	   pathmatch:
	      matching-strategy: ant_path_matcher

이 후 문제없이 잘 실행되었다!

하지만 코드 상에 Swagger 코드가 남아있는게 싫어서 삭제하고 Postman으로 API 문서화를 진행했다는 후문이...ㅎㅎ