1、在ruoyi-common-swagger引用knife4j-spring-boot-starter依赖。

ruoyi-common-swagger服务的pom.xml中加入

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

2、在网关服务ruoyi-gateway引用knife4j-spring-ui依赖

ruoyi-gateway服务的pom.xml中加入

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-ui</artifactId>
    <version>3.0.3</version>
</dependency>

3、访问页面验证是否成功

http://127.0.0.1:8080/doc.html#/home
在这里插入图片描述

注意:

如果进入界面是页面,先检查ruoyi–gateway-dev.yml配置文件的routes配置的先后顺序的服务是否启动

假如ruoyi-gen在第一位,但是这个服务却没有启动,就会出现空白页.
启动ruoyi-gen再次访问,发现可以了,其实是因为第一个分组是ruoyi-gen的,所以是空白页面。

解决办法:

去nacos修改ruoyi–gateway-dev.yml这个配置文件将routes下的id为ruoyi-system提到首位置就行了,这时候knife4j默认打开的分组是ruoyi-system,因为ruoyi-system是必启动的,所以就不会出现问题了。

    routes:
        # 系统模块
        - id: ruoyi-system
          uri: lb://ruoyi-system
          predicates:
            - Path=/system/**
          filters:
            - StripPrefix=1
        # 认证中心
        - id: ruoyi-auth
          uri: lb://ruoyi-auth
          predicates:
            - Path=/auth/**
          filters:
            # 验证码处理
            - CacheRequestFilter
            - ValidateCodeFilter
            - StripPrefix=1
Logo

快速构建 Web 应用程序

更多推荐