spring-admin和knife4j版本冲突问题

文章描述了在使用SpringBoot2.7.12版本时,集成spring-admin和knife4j3.0.3版本导致的ApplicationContextException,主要问题是`documentationPluginsBootstrapper`启动失败。通过添加`spring.mvc.pathmatch.matching-strategy=ant-path-matcher`配置解决了这个问题。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

spring-admin和knife4j版本冲突问题

Spring Boot Admin本质上集成了actuator,将实时警报,此外添加一些实时警报功能等。

我使用的spring-boot版本:

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.12</version>
        <relativePath/>
    </parent>

knife4j

    <dependency>
        <groupId>com.github.xiaoymin</groupId>
        <artifactId>knife4j-spring-boot-starter</artifactId>
        <version>3.0.3</version>
    </dependency>

spring-admin

    <dependency>
        <groupId>de.codecentric</groupId>
        <artifactId>spring-boot-admin-starter-server</artifactId>
        <version>2.7.10</version>
    </dependency>
    <dependency>
        <groupId>de.codecentric</groupId>
        <artifactId>spring-boot-admin-starter-client</artifactId>
        <version>2.7.10</version>
    </dependency>

在有spring-boot-starter-actuator依赖的情况下报错

WARN  o.s.b.w.s.c.AnnotationConfigServletWebServerApplicationContext 
--> Exception encountered during context initialization 
- cancelling refresh attempt: org.springframework.context.ApplicationContextException: 
Failed to start bean 'documentationPluginsBootstrapper'; 
nested exception is java.lang.NullPointerException
org.springframework.context.ApplicationContextException: Failed to start bean 'documentationPluginsBootstrapper'; nested exception is java.lang.NullPointerException
	at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:181)
	at org.springframework.context.support.DefaultLifecycleProcessor.access$200(DefaultLifecycleProcessor.java:54)
	at org.springframework.context.support.DefaultLifecycleProcessor$LifecycleGroup.start(DefaultLifecycleProcessor.java:356)
	at java.lang.Iterable.forEach(Iterable.java:75)
	at org.springframework.context.support.DefaultLifecycleProcessor.startBeans(DefaultLifecycleProcessor.java:155)
	at org.springframework.context.support.DefaultLifecycleProcessor.onRefresh(DefaultLifecycleProcessor.java:123)
	at org.springframework.context.support.AbstractApplicationContext.finishRefresh(AbstractApplicationContext.java:937)
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:586)
	at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:147)
	at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:731)
	at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:408)
	at org.springframework.boot.SpringApplication.run(SpringApplication.java:307)
	at com.examboost.api.ApiApplication.main(ApiApplication.java:21)
Caused by: java.lang.NullPointerException: null
	at springfox.documentation.spring.web.WebMvcPatternsRequestConditionWrapper.getPatterns(WebMvcPatternsRequestConditionWrapper.java:56)
	at springfox.documentation.RequestHandler.sortedPaths(RequestHandler.java:113)
	at springfox.documentation.spi.service.contexts.Orderings.lambda$byPatternsCondition$3(Orderings.java:89)
	at java.util.Comparator.lambda$comparing$77a9974f$1(Comparator.java:469)
	at java.util.TimSort.countRunAndMakeAscending(TimSort.java:355)
	at java.util.TimSort.sort(TimSort.java:234)
	at java.util.Arrays.sort(Arrays.java:1512)
	at java.util.ArrayList.sort(ArrayList.java:1464)
	at java.util.stream.SortedOps$RefSortingSink.end(SortedOps.java:392)
	at java.util.stream.Sink$ChainedReference.end(Sink.java:258)
	at java.util.stream.Sink$ChainedReference.end(Sink.java:258)
	at java.util.stream.Sink$ChainedReference.end(Sink.java:258)
	at java.util.stream.Sink$ChainedReference.end(Sink.java:258)
	at java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:483)
	at java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:472)
	at java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:708)
	at java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234)
	at java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:566)
	at springfox.documentation.spring.web.plugins.WebMvcRequestHandlerProvider.requestHandlers(WebMvcRequestHandlerProvider.java:81)
	at java.util.stream.ReferencePipeline$3$1.accept(ReferencePipeline.java:193)
	at java.util.ArrayList$ArrayListSpliterator.forEachRemaining(ArrayList.java:1384)
	at java.util.stream.AbstractPipeline.copyInto(AbstractPipeline.java:482)
	at java.util.stream.AbstractPipeline.wrapAndCopyInto(AbstractPipeline.java:472)
	at java.util.stream.ReduceOps$ReduceOp.evaluateSequential(ReduceOps.java:708)
	at java.util.stream.AbstractPipeline.evaluate(AbstractPipeline.java:234)
	at java.util.stream.ReferencePipeline.collect(ReferencePipeline.java:566)
	at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.withDefaults(AbstractDocumentationPluginsBootstrapper.java:107)
	at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.buildContext(AbstractDocumentationPluginsBootstrapper.java:91)
	at springfox.documentation.spring.web.plugins.AbstractDocumentationPluginsBootstrapper.bootstrapDocumentationPlugins(AbstractDocumentationPluginsBootstrapper.java:82)
	at springfox.documentation.spring.web.plugins.DocumentationPluginsBootstrapper.start(DocumentationPluginsBootstrapper.java:100)
	at org.springframework.context.support.DefaultLifecycleProcessor.doStart(DefaultLifecycleProcessor.java:178)
	... 12 common frames omitted

解决

查找到相关issue:https://gitee.com/xiaoym/knife4j/issues/I4JT89

  1. 添加spring.mvc.pathmatch.matching-strategy=ant-path-matcher 配置

  2. 添加到swagger config

    /**
     * 解决springboot升级到2.6.x之后,knife4j报错
     *
     * @param webEndpointsSupplier        the web endpoints supplier
     * @param servletEndpointsSupplier    the servlet endpoints supplier
     * @param controllerEndpointsSupplier the controller endpoints supplier
     * @param endpointMediaTypes          the endpoint media types
     * @param corsProperties              the cors properties
     * @param webEndpointProperties       the web endpoint properties
     * @param environment                 the environment
     * @return the web mvc endpoint handler mapping
     */
    @Bean
    public WebMvcEndpointHandlerMapping webEndpointServletHandlerMapping(
            WebEndpointsSupplier webEndpointsSupplier, ServletEndpointsSupplier servletEndpointsSupplier,
            ControllerEndpointsSupplier controllerEndpointsSupplier, EndpointMediaTypes endpointMediaTypes,
            CorsEndpointProperties corsProperties, WebEndpointProperties webEndpointProperties,
            Environment environment) {
        List<ExposableEndpoint<?>> allEndpoints = new ArrayList<>();
        Collection<ExposableWebEndpoint> webEndpoints = webEndpointsSupplier.getEndpoints();
        allEndpoints.addAll(webEndpoints);
        allEndpoints.addAll(servletEndpointsSupplier.getEndpoints());
        allEndpoints.addAll(controllerEndpointsSupplier.getEndpoints());
        String basePath = webEndpointProperties.getBasePath();
        EndpointMapping endpointMapping = new EndpointMapping(basePath);
        boolean shouldRegisterLinksMapping = shouldRegisterLinksMapping(webEndpointProperties,
                environment, basePath);
        return new WebMvcEndpointHandlerMapping(endpointMapping, webEndpoints, endpointMediaTypes,
                corsProperties.toCorsConfiguration(), new EndpointLinksResolver(allEndpoints, basePath),
                shouldRegisterLinksMapping, null);
    }

    /**
     * shouldRegisterLinksMapping
     *
     * @param webEndpointProperties webEndpointProperties
     * @param environment           environment
     * @param basePath              /
     * @return boolean
     */
    private boolean shouldRegisterLinksMapping(WebEndpointProperties webEndpointProperties,
                                               Environment environment, String basePath) {
        return webEndpointProperties.getDiscovery().isEnabled() && (StringUtils.hasText(basePath)
                || ManagementPortType.get(environment).equals(ManagementPortType.DIFFERENT));
    }

相关链接:

knife4j和springboot-actuator版本冲突问题 - 飘梧的文章 - 知乎
https://zhuanlan.zhihu.com/p/474764240

<think>好的,我现在需要帮助用户找到与Java 11兼容的Knife4j版本。首先,用户提到了之前遇到的一些版本冲突问题,比如Knife4jSpringfox的版本不兼容,还有Spring BootSpring Cloud版本不兼容问题。这些都是版本依赖的问题,所以需要仔细分析。 首先,Knife4j是基于Swagger的增强工具,通常与Springfox一起使用。但用户现在关心的是Java 11的兼容性。Java 11相对于Java 8在模块化一些API上有变化,所以需要确认Knife4j的各个版本是否支持Java 11。 查阅Knife4j的官方文档或GitHub仓库可能会有相关信息。另外,用户之前的引用中提到,Knife4j 2.0.7需要Springfox的兼容版本,而版本冲突时可能需要调整Knife4j版本。例如,引用[1]中提到将Knife4j降到2.0.5解决了问题,但那是关于Springfox的兼容性,可能Java版本无关。 接下来,用户需要的是与Java 11兼容的Knife4j版本。一般来说,如果Knife4j依赖的库(如Springfox、Spring Boot)支持Java 11,那么Knife4j本身也应该兼容。查看Spring Boot的版本支持情况,比如Spring Boot 2.2.x及以上通常支持Java 11。引用[3]中提到用户使用Spring Boot 2.2.2.RELEASE,但Spring Cloud Hoxton.SR8不兼容,这可能引起其他问题,但Java版本支持可能没问题。 另外,引用[5]提到添加Guava依赖解决某些问题,Guava的版本也可能影响兼容性。需要确保所有传递依赖都兼容Java 11。 根据经验,Knife4j的较新版本应该支持Java 11。比如,Knife4j 2.0.9或更高版本可能更适合。同时,需要检查Springfox的版本是否支持Java 11。Springfox 2.9.2可能较旧,但如果有更新的版本可能更好。如果Springfox不支持,可能需要考虑迁移到SpringDoc OpenAPI,因为Springfox已经停止维护,而SpringDoc支持更新的Java版本Spring Boot版本。 因此,建议用户升级到Knife4j的最新稳定版,并确保其依赖的Spring Boot、Springfox或其他库也兼容Java 11。如果遇到问题,可能需要调整相关依赖的版本,或者迁移到SpringDoc。</think>根据引用内容版本兼容性分析,与Java 11兼容的推荐Knife4j版本如下: ### 1. 基础版本选择 - **Knife4j 2.0.9+** 支持Java 11,且需配合以下依赖: ```xml <dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>knife4j-spring-boot-starter</artifactId> <version>2.0.9</version> </dependency> ``` 该版本已解决早期版本的依赖冲突问题,并明确支持Spring Boot 2.2+(兼容Java 11)[^3][^5] ### 2. 依赖配置要点 - **Spring Boot版本**:需使用2.3.x及以上(推荐2.5.x),因Spring Boot 2.2.x与部分云组件存在兼容风险 - **Springfox兼容性**:若仍需Springfox,建议使用2.10.5,但更推荐迁移到**SpringDoc OpenAPI**(替代方案): ```xml <dependency> <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> <version>1.6.9</version> </dependency> ``` ### 3. 配置文件增强 高版本Knife4j需在`application.yml`中显式启用增强功能[^2]: ```yaml knife4j: enable: true basic: enable: true username: admin password: 123456 ``` ### 4. 冲突解决示例 若出现依赖冲突(如Guava库),需手动指定版本[^5]: ```xml <dependency> <groupId>com.google.guava</groupId> <artifactId>guava</artifactId> <version>30.1.1-jre</version> </dependency> ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值