快捷導(dǎo)航

knife4j+springboot3.4異常無(wú)法正確展示文檔

更新時(shí)間：2025年01月13日 10:01:40 作者：立小言先森

本文主要介紹了knife4j+springboot3.4異常無(wú)法正確展示文檔,文中通過(guò)示例代碼介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來(lái)一起學(xué)習(xí)學(xué)習(xí)吧

場(chǎng)景復(fù)現(xiàn)：

knife4j-openapi3-jakarta-spring-boot-starter版本

<!-- https://mvnrepository.com/artifact/com.github.xiaoymin/knife4j-openapi3-jakarta-spring-boot-starter -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
    <version>4.5.0</version>
</dependency>

原來(lái)使用springboot3.3.5版本，先升級(jí)到3.4.0版本
通過(guò)http://ip:port/doc.html訪問(wèn)接口文檔發(fā)現(xiàn)訪問(wèn)/v3/api-docs接口時(shí)報(bào)

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

通過(guò)分析異常日志發(fā)現(xiàn)是ControllerAdviceBean類報(bào)錯(cuò)，在springboot3.3.5時(shí)spring-web版本是6.1.14，springboot3.4版本是6.2.0版本。

通過(guò)springboot全局異常捕獲堆棧信息發(fā)現(xiàn)：

org.springdoc.core.service.GenericResponseService.lambda$getGenericMapResponse$8(GenericResponseService.java:702)

GenericResponseService類是在如下包：

<!-- https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-starter-common -->
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-starter-common</artifactId>
    <version>2.3.0</version>
</dependency>

GenericResponseService類的702行代碼如下(ControllerAdviceBean類使用一個(gè)參數(shù)的構(gòu)造函數(shù)，但是報(bào)異常)：

List<ControllerAdviceInfo> controllerAdviceInfosNotInThisBean = controllerAdviceInfos.stream()
					.filter(controllerAdviceInfo ->
							new ControllerAdviceBean(controllerAdviceInfo.getControllerAdvice()).isApplicableToBeanType(beanType))
					.filter(controllerAdviceInfo -> !beanType.equals(controllerAdviceInfo.getControllerAdvice().getClass()))
					.toList();

spring-web6.1.14版本中ControllerAdviceBean的構(gòu)造函數(shù)：

	public ControllerAdviceBean(Object bean) {
		Assert.notNull(bean, "Bean must not be null");
		this.beanOrName = bean;
		this.isSingleton = true;
		this.resolvedBean = bean;
		this.beanType = ClassUtils.getUserClass(bean.getClass());
		this.beanTypePredicate = createBeanTypePredicate(this.beanType);
		this.beanFactory = null;
	}

spring-web6.2.0版本中ControllerAdviceBean的構(gòu)造函數(shù)：

	public ControllerAdviceBean(String beanName, BeanFactory beanFactory, ControllerAdvice controllerAdvice) {
		Assert.hasText(beanName, "Bean name must contain text");
		Assert.notNull(beanFactory, "BeanFactory must not be null");
		Assert.isTrue(beanFactory.containsBean(beanName), () -> "BeanFactory [" + beanFactory +
				"] does not contain specified controller advice bean '" + beanName + "'");
		Assert.notNull(controllerAdvice, "ControllerAdvice must not be null");

		this.beanName = beanName;
		this.isSingleton = beanFactory.isSingleton(beanName);
		this.beanType = getBeanType(beanName, beanFactory);
		this.beanTypePredicate = createBeanTypePredicate(controllerAdvice);
		this.beanFactory = beanFactory;
	}

此類中的構(gòu)造函數(shù)已經(jīng)變更為4個(gè)，已經(jīng)不存在一個(gè)參數(shù)的構(gòu)造函數(shù)了。

springdoc-openapi-starter-common文檔當(dāng)前已經(jīng)升級(jí)到2.7.0版本

<!-- https://mvnrepository.com/artifact/org.springdoc/springdoc-openapi-starter-common -->
<dependency>
    <groupId>org.springdoc</groupId>
    <artifactId>springdoc-openapi-starter-common</artifactId>
    <version>2.7.0</version>
</dependency>

結(jié)論：期待knife4j-openapi3-jakarta-spring-boot-starter早日升級(jí)，兼容最新版本的spring;

開(kāi)源SDK:https://github.com/mingyang66/spring-parent

到此這篇關(guān)于knife4j+springboot3.4異常無(wú)法正確展示文檔的文章就介紹到這了,更多相關(guān)knife4j springboot3.4異常無(wú)法展示內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: