SpringBoot3整合Knife4j生成介面文件

1. 匯入依賴

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

注意：

• Spring Boot 3 只支援OpenAPI3規範
• Knife4j提供的starter已經引用springdoc-openapi的jar，開發者需注意避免jar包衝突
• JDK版本必須 >= 17

2.編寫配置檔案

 @Configuration
  public class OpenAPI {
      @Bean("indexAPI")
      public io.swagger.v3.oas.models.OpenAPI openAPI() {
         return new io.swagger.v3.oas.models.OpenAPI()
               .info(apiInfo());
      }

      private Info apiInfo() {
          return new Info()
                .title("管理系統")
                .description("基於SpringBoot3和vue打造的管理系統")
                .version("1.0")
                .contact(new Contact().name("***").email("***"));
      }

}

3.常用的註解有

• @Tag
• @Operation
• @Schema