springboot3.5.0
com.github.xiaoymin
knife4j-openapi3-jakarta-spring-boot-starter
4.4.0
`import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@configuration
public class Knife4jConfig {
@Bean
public GroupedOpenApi configGroupedOpenApi() {
// 匹配接口路径
String[] matchApiPaths = {"/api/**"};
// 匹配包路径
String[] matchPackages = {"com.yc"};
// 定义分组信息
return GroupedOpenApi.builder()
// 分组显示名称
.displayName("订单服务")
// 分组名称(使用英文字符、数字、-,不能以数字或-开头)保持gateway_route的uri前缀lb://后的字符一致,不然分组配置信息在网关聚合中不生效
.group("cnpp-order")
// 分组接口路径
.pathsToMatch(matchApiPaths)
// 分组接口扫描的包路径
.packagesToScan(matchPackages)
// .addOpenApiMethodFilter(method -> true)
.build();
}
/**
* 配置接口信息
*
* @return OpenAPI
*/
@Bean
public OpenAPI configOpenApi() {
// 信息人信息
Contact contact = new Contact();
// 姓名
contact.setName("yy");
// 邮箱
contact.setEmail("");
return new OpenAPI()
.info(new Info()
// 标题
.title("订单服务")
// 描述信息
.description("订单相关接口")
// 联系人
.contact(contact)
// 版本
.version("1.0")
// 服务条款
.termsOfService("")
// 许可证
.license(new License())
);
}
}
`
项目正常启动后,通过gateway聚合文档调用接口文档信息时出现以下异常
2026-05-08 17:20:04.015 [http-nio-8084-exec-1] ERROR [803207584658437,] [com.ccreate.exception.SystemExceptionHandler] - 未知异常 [GET /v3/api-docs/cnpp-order] - Handler dispatch failed: java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.(java.lang.Object)'
jakarta.servlet.ServletException: Handler dispatch failed: java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.(java.lang.Object)'
at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1104)
at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:979)
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1014)
at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:903)
at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:564)
at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:885)
at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:658)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:195)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:140)
at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:51)
springboot3.5.0
com.github.xiaoymin
knife4j-openapi3-jakarta-spring-boot-starter
4.4.0
`import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@configuration
public class Knife4jConfig {
// .addOpenApiMethodFilter(method -> true)
.build();
}
}
`
项目正常启动后,通过gateway聚合文档调用接口文档信息时出现以下异常
2026-05-08 17:20:04.015 [http-nio-8084-exec-1] ERROR [803207584658437,] [com.ccreate.exception.SystemExceptionHandler] - 未知异常 [GET /v3/api-docs/cnpp-order] - Handler dispatch failed: java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.(java.lang.Object)'
jakarta.servlet.ServletException: Handler dispatch failed: java.lang.NoSuchMethodError: 'void org.springframework.web.method.ControllerAdviceBean.(java.lang.Object)'
at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:1104)
at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:979)
at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:1014)
at org.springframework.web.servlet.FrameworkServlet.doGet(FrameworkServlet.java:903)
at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:564)
at org.springframework.web.servlet.FrameworkServlet.service(FrameworkServlet.java:885)
at jakarta.servlet.http.HttpServlet.service(HttpServlet.java:658)
at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:195)
at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:140)
at org.apache.tomcat.websocket.server.WsFilter.doFilter(WsFilter.java:51)