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

一、问题描述

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