knife4j使用openapi3.0注解@schema报错

Question

Java 项目环境与问题

环境

• JDK: 1.8
• Spring Boot: 2.7.14

引入的 Knife4j 依赖

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-spring-boot-starter</artifactId>
    <version>4.3.0</version>
</dependency>

• 问题描述
  在接口配置 @Tag 和 @Operation 都没有问题，Swagger 和 Knife4j 文档能正常显示。但当在实体类中添加了 @Schema 注解后，Swagger 显示以下错误：
  Unable to render this definition
  The provided definition does not specify a valid version field.
  Please indicate a valid Swagger or OpenAPI version field. Supported version fields are swagger: "2.0" and those that match openapi: 3.0.n (for example, openapi: 3.0.0).
  同时，Knife4j 直接没有首页，按 F12 显示 500 服务器内部错误。

需要帮助
希望能得到关于以下问题的帮助：

解决 Swagger 提示的版本字段无效问题。
解决 Knife4j 首页无法加载的问题。

Answer 1

以下回复参考：皆我百晓生、券券喵儿等免费微信小程序作答:

关于你提到的两个问题，我会尝试给出可能的解决方案。但请注意，解决方案可能会依赖于你的项目配置和环境。如果你能提供更多的信息，比如错误消息或更详细的代码片段，我可能会提供更准确的解决方案。

1. 解决 Swagger 提示的版本字段无效问题

这个问题可能是由于 Swagger 或 Knife4j 无法正确解析你的 OpenAPI 注解导致的。首先，确保你的项目中已经正确引入了 Swagger 和 Knife4j 的依赖，并且版本是兼容的。其次，检查你的注解是否正确使用。例如，使用 @Schema 注解时，确保你提供的参数是合法的。以下是一个基本的 @Schema 注解使用示例：

import io.swagger.v3.oas.annotations.media.Schema;

public class MyModel {
    @Schema(description = "模型的唯一标识符")
    private String id;
    // 其他字段和方法...
}

如果问题仍然存在，尝试更新 Swagger 和 Knife4j 到最新版本，看看问题是否得到解决。有时候，库的旧版本可能会有已知的问题或不兼容的问题。

2. 解决 Knife4j 首页无法加载的问题

这个问题可能有多种原因。首先，确保你的项目已经正确配置了 Knife4j。其次，检查你的服务器是否正在运行并且能够访问。如果你使用的是 Spring Boot，确保你的应用程序正在运行并且端口是正确的。你也可以尝试访问其他页面或接口，看看是否有其他错误消息或异常。

另外，检查你的浏览器控制台和网络日志，看看是否有任何错误消息或请求失败的记录。这可能会帮助你找到问题的根源。如果问题仍然存在，尝试更新 Knife4j 到最新版本，看看问题是否得到解决。有时候，库的旧版本可能会有已知的问题或不兼容的问题。如果可能的话，也可以尝试查看 Knife4j 的官方文档或社区寻求帮助。

如果你提供更多的信息或错误消息，我可能能够提供更具体的解决方案。