[Spring] nested exception is java.lang.NullPointerException

서론

spring boot 2.6.7을 사용 중이고 swagger 3.0.0 버전을 이용하기 위해 진행하던 중 아래와 같은 오류가 발생했습니다.

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

현재 gradle을 사용중이기에 아래와 같이 dependencies에는 아래와 같이 추가해 주었습니다.

implementation 'io.springfox:springfox-boot-starter:3.0.0'

---

maven일 경우 아래와 같이 추가하면 됩니다.

<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-swagger2</artifactId>
	<version>3.0.0</version>
</dependency>
<dependency>
   <groupId>io.springfox</groupId>
   <artifactId>springfox-swagger-ui</artifactId>
   <version>3.0.0</version>
</dependency>
<dependency>
	<groupId>io.springfox</groupId>
	<artifactId>springfox-boot-starter</artifactId>
	<version>3.0.0</version>
</dependency>

---

SwaggerConfig.java의 코드는 아래와 같습니다.

@Configuration
public class SwaggerConfig {

    @Bean
    public Docket api() {
        return new Docket(DocumentationType.OAS_30)
                .useDefaultResponseMessages(false)
                .select()
                .apis(RequestHandlerSelectors.basePackage(""))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(apiInfo());
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Swagger Test")
                .description("SwaggerConfig")
                .version("3.0")
                .build();
    }
}

---

원인

Spring boot 2.6버전 이후 spring.mvc.pathmatch.matching-strategy의 값이 ant_apth_matcher에서 path_pattern_parser로 변경되면서 swagger를 포함한 몇몇 라이브러리가 오류를 발생시킨다고 합니다.

 

해결

application.yml 파일에 아래의 코드를 넣어줌으로써 해결이 가능합니다.

spring:
  mvc:
    pathmatch:
      matching-strategy: ant_path_matcher

정상 작동하는 모습

 

참고

https://github.com/spring-projects/spring-boot/wiki/Spring-Boot-2.6-Release-Notes#pathpattern-based-path-matching-strategy-for-spring-mvc