SpringBoot에서 특정 라이브러리를 추가하면 해당 오류를 만날 수 있습니다.

org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException

오류 원인

최신 SpringBoot에서 특정 라이브러리를 지원하지 않기 때문에 발생하는 문제입니다.
특히 SpringFox에서 일부 라이브러리 업데이트가 중지됨에 따라 SpringBoot 2.6 버전 이상에서 오류가 발생합니다.

오류 해결 - 첫 번째

SpringBoot 2.6 버전 이후에 spring.mvc.pathmatch.matching-strategy 기본 값이 path_pattern_parser로 변경됐습니다.
따라서 예전 값으로 ant_path_matcher로 변경하면 됩니다.

application.properties

spring.mvc.pathmatch.matching-strategy=ant_path_matcher

application.yml

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

오류 해결 - 두 번째

문제가 되는 라이브러리의 대체 라이브러리를 찾아서 교체합니다.
최신 버전의 SpringBoot를 지원하지 않는 라이브러리는 교체하는 게 좋습니다.

최근에 문제가 됐던 SpringFox 라이브러리들입니다.

dependencies {
    implementation("io.springfox:springfox-boot-starter:3.0.0")
    implementation("io.springfox:springfox-swagger2:3.0.0")
    implementation("io.springfox:springfox-swagger-ui:3.0.0")
}

오류 해결 - 세 번째

SpringBoot 버전을 2.6 이전으로 내립니다.
하지만 최신 버전을 사용하는게 좋으므로 권장하는 방법은 아닙니다.

물론 필수 라이브러리를 꼭 사용해야 한다면 SpringBoot 하위 버전을 일단 사용하고,
이후에 해당 라이브러리가 업데이트 되면 상위 버전으로 변경해도 됩니다.