[issue] Failed to start bean 'documentationPluginsBootstrapper’

계기

프로젝트에 Swagger API를 적용하는 중 해당 이슈를 만났다. 나중에 새로운 프로젝트에 적용할 때도 만날 수 있을 이슈라고 판단되어서 정리를 해보고자 한다. 생각보다는 간단한 문제였다.

 

탐구

해당 이슈는 SpringBoot가 버전 업을 하면서 `mvc - pathmatch - matching-strategy` 기본 값이 `ant_path_ matcher` 에서 `path_pattern_parser` 으로 변경되면서 생긴 문제였다. 고로 yml 혹은 properties 파일에서 기본 값을 수정하면 해결된다.

 

그렇다면 프레임워크 안에서 `matching-strategy` 가 하는 역할이 무엇일까

 

 

 

내부적으로 이 설정 값은 2개의 Enum 데이터를 가지고 있고 `AntPathMatcher`와 `PathPatternParser`는 URI Pattern을 파악하는 역할을 수행한다. 두 설정 값의 차이점으론 URI Pattern 구조를 파악하는 방식의 차이가 있다고 이해하면 될 것 같다. 더 깊게 이해하고 싶다면 Spring Document에서 해당 내용을 다루고 있으니 공식 문서를 참고하는 것을 추천한다.