Gateway 聚合配置

• 引入依赖

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-gateway-spring-boot-starter</artifactId>
</dependency>

• 程序配置

knife4j:
  gateway:
    enabled: true                  # 开启网关聚合
    strategy: discover             # 网关聚合策略 discover表示服务中心聚合
    discover:
      # OpenAPI 3.0 规范
      version: openapi3
      enabled: true
      excluded-services:           # 排除在外的接口文档(服务名称)
        - gateway-server

子服务配置

• 引入依赖

<!-- 根据规范选择openapi或者swagger依赖，springboot3可以引入新版依赖 [jakarta] -->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
</dependency>

• 程序配置

springdoc:
  swagger-ui:
    path: /swagger-ui.html
    tags-sorter: alpha
    operations-sorter: alpha
  api-docs:
    path: /v3/api-docs
  group-configs:
    - group: 'system'
      paths-to-match: '/system/**'
      packages-to-scan:
        # 配置接口文档扫描包路径，每个服务的路径不同
        - online.initline.boot.system


# knife4j的增强配置，不需要增强可以不配
knife4j:
  enable: true
  setting:
    language: zh_cn