[오류 해결] Spring boot - Swagger, Redisson 적용 시 버전 conflict 문제 "Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException"

2023. 11. 6. 03:23·etc/Trouble Shooting

오류 발생 


Redisson을 처음으로 사용해 보려고 설정을 완료하고 일단 한번 빌드하고 실행해 봤는데,

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

이런 예외가 터지면서 실행이 중단되었다.

 

swagger build.gradle

일단 이 문제가 발생한 프로젝트의 swagger implementation문이다.

//swagger
implementation 'io.springfox:springfox-boot-starter:3.0.0'
implementation 'io.springfox:springfox-swagger-ui:3.0.0'

Redisson build.gradle

implementation 'org.redisson:redisson-spring-boot-starter:3.17.0'
추가로, redisson 라이브러리는 스프링부트 2.xx 에서는 3.17.x 이하로 사용해야 한다고 한다.
3.18부터는 스프링부트 3.0부터 지원된다고 한다. 

에러 메시지 상세

더보기
org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
	at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:182) ~[spring-context-5.3.30.jar:5.3.30]
	at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:54) ~[spring-context-5.3.30.jar:5.3.30]
	at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:357) ~[spring-context-5.3.30.jar:5.3.30]
	at java.base/java.lang.Iterable.forEach(Iterable.java:75) ~[na:na]
	at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:156) ~[spring-context-5.3.30.jar:5.3.30]
	at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:124) ~[spring-context-5.3.30.jar:5.3.30]
	at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:938) ~[spring-context-5.3.30.jar:5.3.30]
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:586) ~[spring-context-5.3.30.jar:5.3.30]
	at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:147) ~[spring-boot-2.7.16.jar:2.7.16]
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:731) ~[spring-boot-2.7.16.jar:2.7.16]
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:408) ~[spring-boot-2.7.16.jar:2.7.16]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:307) ~[spring-boot-2.7.16.jar:2.7.16]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1303) ~[spring-boot-2.7.16.jar:2.7.16]
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:1292) ~[spring-boot-2.7.16.jar:2.7.16]
	at com.example.fitnessrecord.FitnessRecordApplication.main(XXXXXXXApplication.java:14) ~[classes/:na]
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:na]
	at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:na]
	at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:na]
	at java.base/java.lang.reflect.Method.invoke(Method.java:566) ~[na:na]
	at org.springframework.boot.devtools.restart.RestartLauncher.run(RestartLauncher.java:50) ~[spring-boot-devtools-2.7.16.jar:2.7.16]
Caused by: java.lang.NullPointerException: null
	at springfox.documentation.spring.web.WebMvcPatternsRequestConditionWrapper.getPatterns(WebMvcPatternsRequestConditionWrapper.java:56) ~[springfox-spring-webmvc-3.0.0.jar:3.0.0]
	at springfox.documentation.RequestHandler.sortedPaths(RequestHandler.java:113) ~[springfox-core-3.0.0.jar:3.0.0]
	at springfox.documentation.spi.service.contexts.Orderings.lambda$byPatternsCondition$3(Orderings.java:89) ~[springfox-spi-3.0.0.jar:3.0.0]
	at java.base/java.util.Comparator.lambda$comparing$77a9974f$1(Comparator.java:469) ~[na:na]
	at java.base/java.util.TimSort.countRunAndMakeAscending(TimSort.java:355) ~[na:na]
	at java.base/java.util.TimSort.sort(TimSort.java:234) ~[na:na]
	at java.base/java.util.Arrays.sort(Arrays.java:1515) ~[na:na]
	at java.base/java.util.ArrayList.sort(ArrayList.java:1750) ~[na:na]
	at java.base/java.util.stream.SortedOps$RefSortingSink.end(SortedOps.java:392) ~[na:na]
	at java.base/java.util.stream.Sink$ChainedReference.end(Sink.java:258) ~[na:na]
	at java.base/java.util.stream.Sink$ChainedReference.end(Sink.java:258) ~[na:na]
	at java.base/java.util.stream.Sink$ChainedReference.end(Sink.java:258) ~[na:na]
	at java.base/java.util.stream.Sink$ChainedReference.end(Sink.java:258) ~[na:na]
	at java.base/java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:485) ~[na:na]
	at java.base/java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:474) ~[na:na]
	at java.base/java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:913) ~[na:na]
	at java.base/java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234) ~[na:na]
	at java.base/java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:578) ~[na:na]
	at springfox.documentation.spring.web.plugins.WebMvcRequestHandlerProvider.requestHandlers(WebMvcRequestHandlerProvider.java:81) ~[springfox-spring-webmvc-3.0.0.jar:3.0.0]
	at java.base/java.util.stream.ReferencePipeline$3$1.accept(ReferencePipeline.java:195) ~[na:na]
	at java.base/java.util.ArrayList$ArrayListSpliterator.forEachRemaining(ArrayList.java:1655) ~[na:na]
	at java.base/java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:484) ~[na:na]
	at java.base/java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:474) ~[na:na]
	at java.base/java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:913) ~[na:na]
	at java.base/java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234) ~[na:na]
	at java.base/java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:578) ~[na:na]
	at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.withDefaults(AbstractDocumentationPluginsBootstrapper.java:107) ~[springfox-spring-web-3.0.0.jar:3.0.0]
	at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.buildContext(AbstractDocumentationPluginsBootstrapper.java:91) ~[springfox-spring-web-3.0.0.jar:3.0.0]
	at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.bootstrapDocumentationPlugins(AbstractDocumentationPluginsBootstrapper.java:82) ~[springfox-spring-web-3.0.0.jar:3.0.0]
	at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.start(DocumentationPluginsBootstrapper.java:100) ~[springfox-spring-web-3.0.0.jar:3.0.0]
	at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:179) ~[spring-context-5.3.30.jar:5.3.30]

 

일단 해당 에러 메시지는 

documentationpluginsBootstrapper라는 빈을 시작하는 중 문제가 발생했음을 말한다.

또한, NullPointerException이 발생한 것을 볼 수 있다.

 

그리고 아래 라인을 볼 때 springfox. 즉, swagger 관련해서 문제가 터진 것 같았다.

springfox.documentation.spring.web.WebMvcPatternsRequestConditionWrapper.getPatterns(WebMvcPatternsRequestConditionWrapper.java:56) ~[springfox-spring-webmvc-3.0.0.jar:3.0.0]

 

 

 

그래서 해당 내용을 바탕으로 서칭 해본 결과 인프런 질문 글에서 이 문제를 해결해 주신 글을 발견했다. (맨 아래에 첨부)

 

아래 springfox 깃허브에 해결 방법에 대한 설명이 있다.

https://github.com/springfox/springfox/issues/3462#issuecomment-979548234

 

해결 방법


1. WebMvcRequestHandlerProvider 클래스 생성

WebMvcRequestHandlerProvider  <= 이 이름으로 아무 위치에나 클래스를 하나 생성한다.

 

2. 아래 링크의 클래스를 전체 복사한다.

https://github.com/springfox/springfox/blob/master/springfox-spring-webmvc/src/main/java/springfox/documentation/spring/web/plugins/WebMvcRequestHandlerProvider.java

 

3. 붙여 넣기

위에서 만든 WebMvcRequestHandlerProvider에 붙여 넣기 한다.

 

붙여넣기 하면 위와 같이 패키지가 잘못되었다고 경고 줄이 뜬다.

해당 클래스는 꼭 위에서 명시한 springfox.documentation.spring.web.plugins 패키지에 위치해야만 한다.

 

빨간 줄 된 라인에 도움말을 받으면 아래와 같이 해당 패키지로 이동시킬 수 있다.

 

위와 같이 알맞은 패키지에 클래스가 위치한 것을 볼 수 있다.

 

4. 코드 수정

63번 라인을 아래와 같이 수정한다.

 

(수정 전)

this.handlerMappings = handlerMappings;

 

(수정 후)

this.handlerMappings = handlerMappings.stream()
    .filter(mapping -> mapping.getPatternParser() == null)
    .collect(Collectors.toList());

 

5. 문제 해결

이렇게 하면 잘 실행된다.

이렇게 하면 해결되는 이유는 정확히 모르겠지만, springfox에서 제시한 해결책이기 때문에 그냥 따라 써도 될 것 같다.

 

 

(인프런 질문, 답변 글)

https://www.inflearn.com/questions/625844/%EC%84%A0%EC%83%9D%EB%8B%98%EC%9D%B4-%ED%94%84%EB%A1%9C%EC%A0%9D%ED%8A%B8-spring-%EB%B2%84%EC%A0%84-%EA%B8%B0%EC%A4%80%EC%9C%BC%EB%A1%9C-%EC%8B%A4%EB%AC%B4-%ED%86%B5%ED%95%B4-redisson-%EC%A0%81%EC%9A%A9%EC%8B%9C-%EB%AC%B8%EC%A0%9C

 

 

반응형
저작자표시 (새창열림)

'etc > Trouble Shooting' 카테고리의 다른 글

[트러블슈팅/swagger] DTO에서 inner class 사용 시 swagger에서 인식하지 못하는 오류 해결  (0) 2023.12.12
[트러블슈팅/docker/mongodb] mongo: not found 에러 / docker에 mongodb 이미지 띄우고 실행하기  (0) 2023.12.11
[JPA, Test, Mockito] repository.save() test 시 오류 발생 org.mockito.exceptions.misusing.PotentialStubbingProblem 문제 해결  (0) 2023.12.03
[IntelliJ] 인코딩(Encoding) 설정 / 한글 깨짐 문제 해결  (1) 2023.07.29
[ port already in use ] 오류 해결 방법  (0) 2023.04.21
'etc/Trouble Shooting' 카테고리의 다른 글
  • [트러블슈팅/docker/mongodb] mongo: not found 에러 / docker에 mongodb 이미지 띄우고 실행하기
  • [JPA, Test, Mockito] repository.save() test 시 오류 발생 org.mockito.exceptions.misusing.PotentialStubbingProblem 문제 해결
  • [IntelliJ] 인코딩(Encoding) 설정 / 한글 깨짐 문제 해결
  • [ port already in use ] 오류 해결 방법
HSRyuuu
HSRyuuu
Web Server Developer hsryuuu
  • HSRyuuu
    HS_dev_log
    HSRyuuu
  • 전체
    오늘
    어제
  • 링크

    • Github
    • 전체 글 보기 (251)
      • Spring (37)
      • Infra & DevOps (20)
      • Java (25)
      • AI (8)
      • Database (28)
      • Web & Network (14)
      • 자료구조 & 알고리즘 (30)
      • Computer Science (24)
      • Frontend (17)
        • Vue.js & Nuxt.js (9)
        • JSP_Thymeleaf (7)
      • etc (48)
        • 오픈소스 라이브러리 (5)
        • 코딩테스트 (13)
        • Trouble Shooting (7)
        • Tech Interview (6)
        • Book Review (9)
        • 끄적끄적... (6)
        • 개인 프로젝트 (2)
  • 태그

    제로베이스
    TechInterview
    docker
    Queue
    Linux
    클린코드
    HTTP
    기술면접
    트랜잭션
    Java
    JPA
    Spring
    web
    백엔드공부
    백엔드스쿨
    리눅스
    Nuxt3
    Redisson
    mybatis
    Database
    cleancode
    MySQL
    백엔드기술면접
    SpringBoot
    개발자
    백준
    SQL
    Redis
    자료구조
    백엔드
  • 블로그 메뉴

    • 홈
    • 태그
  • hELLO· Designed By정상우.v4.10.4
HSRyuuu
[오류 해결] Spring boot - Swagger, Redisson 적용 시 버전 conflict 문제 "Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException"
상단으로

티스토리툴바