新版若依微服务增强swagger增强集成knife4j

原创于 2025-11-03 16:24:23 发布 · 452 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#微服务 #架构 #云原生

一、pom文件处理

1.父pom增加统一的版本控制

<knife4j.version>4.5.0</knife4j.version>

在这里插入图片描述
2.swagger服务的pom中删除 springdoc-openapi-ui 依赖，增加 knife4j-openapi3-ui依赖

        <!-- knife4j -->
        <dependency>
            <groupId>io.springboot</groupId>
            <artifactId>knife4j-openapi3-ui</artifactId>
            <version>${knife4j.version}</version>
        </dependency>

在这里插入图片描述
3.gateway服务的pom中删除 springdoc-openapi-webflux-ui 依赖，增加 springdoc-openapi-webflux-core依赖和 knife4j-gateway-spring-boot-starter

        <!-- Springdoc -->
        <dependency>
            <groupId>org.springdoc</groupId>
            <artifactId>springdoc-openapi-webflux-core</artifactId>
            <version>${springdoc.version}</version>
        </dependency>

        <!--引入Knife4j的gateway包-->
        <dependency>
            <groupId>com.github.xiaoymin</groupId>
            <artifactId>knife4j-gateway-spring-boot-starter</artifactId>
            <version>${knife4j.version}</version>
        </dependency>

在这里插入图片描述

pom处理完成后开始删除配置文件

配置文件删除

1.swagger服务中的配置文件如下图所示都删除掉

在这里插入图片描述
2.gateway服务中的 SpringDocConfig文件删除掉

gateway的nacos配置文件增加knife4j配置

knife4j:
  gateway:
    enabled: true
    tags-sorter: order
    operations-sorter: order
    strategy: manual
    routes:
      - name: 系统模块
        url: /ruoyi-system/v3/api-docs?group=default
        service-name: ruoyi-system
        context-path: /ruoyi-system
        order: 1
      - name: 代码生成
        url: /ruoyi-gen/v3/api-docs?group=default
        service-name: ruoyi-gen
        context-path: /ruoyi-gen
        order: 2
      - name: 定时任务
        url: /ruoyi-job/v3/api-docs?group=default
        service-name: ruoyi-job
        context-path: /ruoyi-job
        order: 3