Springboot2.7 整合 knife4j-openapi2-spring-boot 报错 Failed to start bean ‘documentationPluginsBootstrapper

本贴最后更新于 306 天前,其中的信息可能已经沧海桑田

最近在用 Springboot2.7 整合 knife4j-openapi2-spring-boot-starter 后,发现无法启动项目直接报错

报错信息

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

网上解决办法

当时直接搜索引擎一动,解决办法基本上都是添加一个配置。原因是:Spring Boot 2.6 以上引入的新 PathPatternParser,需要进行配置,不然整合起来会报错

spring.mvc.pathmatch.matching-strategy=ant-path-matcher 

具体问题原因和解决方案

当时以为加上就可以了,结果发现并没有解决问题,问题还是存在,最后网上再次搜索验证,得到的问题原因是和项目引入的其他依赖冲突,当项目当中引入了 spring-boot-starter-actuator 就会出现这个问题。

可用的解决方案是添加一个 bean 配置:

	@Bean
	public static BeanPostProcessor springfoxHandlerProviderBeanPostProcessor() {
	    return new BeanPostProcessor() {

	        @Override
	        public Object postProcessAfterInitialization(Object bean, String beanName) throws BeansException {
	            if (bean instanceof WebMvcRequestHandlerProvider || bean instanceof WebFluxRequestHandlerProvider) {
	                customizeSpringfoxHandlerMappings(getHandlerMappings(bean));
	            }
	            return bean;
	        }

	        private <T extends RequestMappingInfoHandlerMapping> void customizeSpringfoxHandlerMappings(List<T> mappings) {
	            mappings.removeIf(mapping -> mapping.getPatternParser() != null);
	        }

	        @SuppressWarnings("unchecked")
	        private List<RequestMappingInfoHandlerMapping> getHandlerMappings(Object bean) {
	            try {
	                Field field = ReflectionUtils.findField(bean.getClass(), "handlerMappings");
	                field.setAccessible(true);
	                return (List<RequestMappingInfoHandlerMapping>) field.get(bean);
	            } catch (IllegalArgumentException | IllegalAccessException e) {
	                throw new IllegalStateException(e);
	            }
	        }
	    };
	}

最后附上解决资料连接:https://gitee.com/xiaoym/knife4j/issues/I4JT89 (没事多看看 issues,大佬云集)

  • Spring

    Spring 是一个开源框架,是于 2003 年兴起的一个轻量级的 Java 开发框架,由 Rod Johnson 在其著作《Expert One-On-One J2EE Development and Design》中阐述的部分理念和原型衍生而来。它是为了解决企业应用开发的复杂性而创建的。框架的主要优势之一就是其分层架构,分层架构允许使用者选择使用哪一个组件,同时为 JavaEE 应用程序开发提供集成的框架。

    941 引用 • 1458 回帖 • 150 关注
  • knife4j
    4 引用

相关帖子

欢迎来到这里!

我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

注册 关于
请输入回帖内容 ...