springboot升级到3.5.x后knife4j文档无法识别问题及解决过程

更新时间：2025年12月29日 08:59:41 作者：咚咚阳丶

在将Spring Boot从3.3.x升级到3.5.x后,访问接口文档页面时出现错误,原因是knife4j 4.5.0中使用的springdoc-openapi-starter-webmvc-ui版本过低,通过手动替换该依赖并关闭文档增强功能,问题得以解决

一、问题描述

将springboot从3.3.x版本升级到3.5.x后，访问xxx/doc.htm时原来的接口文档不显示了，同时控制台报错

jakarta.servlet.ServletException: Handler dispatch failed: java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.<init>(java.lang.Object)'

二、原因分析

knife4j 4.5.0中的springdoc-openapi-starter-webmvc-ui版本过低

三、解决方案

由于knife4j 4.5.0已是目前最新版本，所以只能手动替换knife4j 中 springdoc-openapi-starter-webmvc-ui版本，先排除springdoc-openapi-starter-webmvc-ui依赖，再单独引入即可

替换前

<!--knife4j & SpringDoc -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
    <version>4.5.0</version> 
</dependency>

替换后

<!-- knife4j & SpringDoc -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
    <version>4.5.0</version>
    <exclusions>
        <exclusion>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
    <version>2.8.13</version>
</dependency>

注意：

还需要修改配置文件，关闭文档增强功能（knife4j.enable = false），这将会导致文档的用户名密码验证被绕过，如果开启文档增强功能的话，访问文档依然会报错，导致文档加载失败，如果不需要开启文档增强功能的话直接这样解决即可，需要进行密码验证的，这只是一个临时解决方案，可以在开发环境这样配置，正式环境依然开启文档增强，不使用线上文档即可，不会影响项目启动。最终还是希望官方早点更新新版本后进行升级。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

详解如何独立使用ribbon实现业务客户端负载均衡
这篇文章主要为大家介绍了详解如何独立使用ribbon实现业务客户端负载均衡，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-06-06
Java synchornized与ReentrantLock处理并发出现的错误
synchronized机制提供了对每个对象相关的隐式监视器锁，并强制所有锁的获取和释放都必须在同一个块结构中。当获取了多个锁时，必须以相反的顺序释放。即synchronized对于锁的释放是隐式的
2023-01-01
Java实现简单的socket通信教程
这篇文章主要介绍了Java实现简单的socket通信教程，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2020-12-12
使用SpringBoot实现自动发送注册验证码邮件功能
一直以来,我都对程序如何自动发送邮件感到好奇,想象一下,当你在某个网站注册时,输入邮箱后不久就收到一封带有验证码的邮件,这种体验既方便又高效,所以本文给大家介绍了如何用 Spring Boot 实现自动发送注册验证码邮件,需要的朋友可以参考下
2025-04-04
RocketMQ NameServer架构设计启动流程
这篇文章主要为大家介绍了RocketMQ NameServer架构设计启动流程，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2023-02-02
Java基础之堆内存溢出的解决
这篇文章主要介绍了Java基础之堆内存溢出的解决,文中有非常详细的图文示例及代码示例,对正在学习java的小伙伴们有很好地帮助,需要的朋友可以参考下
2021-05-05
StringUtils,CollectionUtils判断为空的方法和原生代码哪个效率最高
这篇文章主要介绍了StringUtils,CollectionUtils判断为空的方法和原生代码哪个效率最高，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-02-02
spring AOP代理执行@EnableAspectJAutoProxy的exposeProxy属性详解
这篇文章主要为大家介绍了spring AOP代理执行@EnableAspectJAutoProxy的exposeProxy属性详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
2023-09-09
Java编程计算兔子生兔子的问题
古典问题：有一对兔子，从出生后第3个月起每个月都生一对兔子，小兔子长到第四个月后每个月又生一对兔子，假如兔子都不死，问每个月的兔子总数为多少
2017-02-02
Java事件监听机制讲解
今天小编就为大家分享一篇关于Java事件监听机制讲解，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
2019-02-02