快捷導(dǎo)航

springboot升級到3.5.x后knife4j文檔無法識(shí)別問題及解決過程

更新時(shí)間：2025年12月29日 08:59:41 作者：咚咚陽丶

在將Spring Boot從3.3.x升級到3.5.x后,訪問接口文檔頁面時(shí)出現(xiàn)錯(cuò)誤,原因是knife4j 4.5.0中使用的springdoc-openapi-starter-webmvc-ui版本過低,通過手動(dòng)替換該依賴并關(guān)閉文檔增強(qiáng)功能,問題得以解決

一、問題描述

將springboot從3.3.x版本升級到3.5.x后，訪問xxx/doc.htm時(shí)原來的接口文檔不顯示了，同時(shí)控制臺(tái)報(bào)錯(cuò)

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已是目前最新版本，所以只能手動(dòng)替換knife4j 中 springdoc-openapi-starter-webmvc-ui版本，先排除springdoc-openapi-starter-webmvc-ui依賴，再單獨(dú)引入即可

替換前

<!--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>

注意：

還需要修改配置文件，關(guān)閉文檔增強(qiáng)功能（knife4j.enable = false），這將會(huì)導(dǎo)致文檔的用戶名密碼驗(yàn)證被繞過，如果開啟文檔增強(qiáng)功能的話，訪問文檔依然會(huì)報(bào)錯(cuò)，導(dǎo)致文檔加載失敗，如果不需要開啟文檔增強(qiáng)功能的話直接這樣解決即可，需要進(jìn)行密碼驗(yàn)證的，這只是一個(gè)臨時(shí)解決方案，可以在開發(fā)環(huán)境這樣配置，正式環(huán)境依然開啟文檔增強(qiáng)，不使用線上文檔即可，不會(huì)影響項(xiàng)目啟動(dòng)。最終還是希望官方早點(diǎn)更新新版本后進(jìn)行升級。

總結(jié)

以上為個(gè)人經(jīng)驗(yàn)，希望能給大家一個(gè)參考，也希望大家多多支持腳本之家。

您可能感興趣的文章:

相關(guān)文章

java實(shí)現(xiàn)圖像轉(zhuǎn)碼為字符畫的方法
這篇文章主要為大家詳細(xì)介紹了java實(shí)現(xiàn)圖像轉(zhuǎn)碼為字符畫的方法，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下
2018-03-03
Mybatis一對多與多對一查詢處理詳解
這篇文章主要給大家介紹了關(guān)于Mybatis一對多與多對一查詢處理的相關(guān)資料，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧
2021-03-03
詳解java調(diào)用存儲(chǔ)過程并封裝成map
這篇文章主要介紹了詳解java調(diào)用存儲(chǔ)過程并封裝成map的相關(guān)資料,希望通過本文能幫助到大家實(shí)現(xiàn)這樣的功能，需要的朋友可以參考下
2017-09-09
Java?try?catch語句異常處理詳解
這篇文章主要給大家介紹了關(guān)于Java?try?catch語句異常處理的相關(guān)資料,Java中的try-catch用于捕獲和處理異常,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下
2023-11-11
RabbitMQ的安裝集群、鏡像隊(duì)列配置規(guī)劃
RabbitMQ 集群是一個(gè)或多個(gè)節(jié)點(diǎn)的邏輯分組,每個(gè)節(jié)點(diǎn)共享用戶、虛擬主機(jī)、隊(duì)列、流、交換機(jī)、綁定、運(yùn)行時(shí)參數(shù)和其他分布式狀態(tài),本文給大家介紹RabbitMQ的安裝集群、鏡像隊(duì)列配置規(guī)劃,感興趣的朋友一起看看吧
2025-09-09
Java實(shí)現(xiàn)矩形碰撞檢測
這篇文章主要為大家詳細(xì)介紹了Java實(shí)現(xiàn)矩形碰撞檢測，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下
2021-06-06
Java實(shí)現(xiàn)線程的暫停和恢復(fù)的示例詳解
這幾天的項(xiàng)目中,客戶給了個(gè)需求,希望我可以開啟一個(gè)任務(wù),想什么時(shí)候暫停就什么時(shí)候暫停,想什么時(shí)候開始就什么時(shí)候開始,所以本文小編給大家介紹了Java實(shí)現(xiàn)線程的暫停和恢復(fù)的示例,需要的朋友可以參考下
2023-11-11
JAVA構(gòu)造函數(shù)不能使用void關(guān)鍵字問題
這篇文章主要介紹了JAVA構(gòu)造函數(shù)不能使用void關(guān)鍵字問題,具有很好的參考價(jià)值,希望對大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教
2024-03-03
Java時(shí)間復(fù)雜度、空間復(fù)雜度的深入詳解
對于一個(gè)算法,其時(shí)間復(fù)雜度和空間復(fù)雜度往往是相互影響的,當(dāng)追求一個(gè)較好的時(shí)間復(fù)雜度時(shí),可能會(huì)使空間復(fù)雜度的性能變差,即可能導(dǎo)致占用較多的存儲(chǔ)空間,這篇文章主要給大家介紹了關(guān)于Java時(shí)間復(fù)雜度、空間復(fù)雜度的相關(guān)資料,需要的朋友可以參考下
2021-11-11
SpringBoot項(xiàng)目中如何動(dòng)態(tài)切換數(shù)據(jù)源、數(shù)據(jù)庫
本文主要介紹了SpringBoot項(xiàng)目中如何動(dòng)態(tài)切換數(shù)據(jù)源、數(shù)據(jù)庫,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧
2025-02-02