tangcy
/
aidmt-ms
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
aidmt-ms/docs/gateway-routes-config.md

2.9 KiB
Raw Blame History

网关路由配置说明

问题分析

用户管理和部门管理的 Swagger 接口不显示，可能是因为网关路由配置缺失。

网关路由配置位置

网关路由配置在 Nacos 配置中心，配置文件名：application-dev.yml（根据环境可能是 application-prod.yml 等）

需要检查的配置

1. 登录 Nacos 控制台

  • 地址：http://127.0.0.1:8848/nacos
  • 用户名/密码：nacos/nacos（默认）

2. 查找配置文件

  • Data ID: application-dev.yml
  • Group: DEFAULT_GROUP
  • 命名空间: 根据实际情况选择

3. 检查路由配置

网关路由配置应该包含以下内容：

spring:
  cloud:
    gateway:
      discovery:
        locator:
          enabled: true  # 启用服务发现自动路由
          lower-case-service-id: true  # 服务ID转小写
      routes:
        # ruoyi-system 路由配置
        - id: ruoyi-system
          uri: lb://ruoyi-system
          predicates:
            - Path=/system/**
          filters:
            - StripPrefix=1
        # ruoyi-manage 路由配置  
        - id: ruoyi-manage
          uri: lb://ruoyi-manage
          predicates:
            - Path=/manage/**
          filters:
            - StripPrefix=1
        # Swagger 路由配置
        - id: ruoyi-system-swagger
          uri: lb://ruoyi-system
          predicates:
            - Path=/ruoyi-system/v3/api-docs/**
          filters:
            - StripPrefix=1
        - id: ruoyi-manage-swagger
          uri: lb://ruoyi-manage
          predicates:
            - Path=/ruoyi-manage/v3/api-docs/**
          filters:
            - StripPrefix=1

如果配置不存在

如果 Nacos 中没有上述路由配置，需要添加：

  1. 登录 Nacos 控制台
  2. 进入"配置管理" -> "配置列表"
  3. 找到或创建 application-dev.yml
  4. 添加上述路由配置
  5. 发布配置
  6. 重启网关服务

验证步骤

  1. 检查服务注册：在 Nacos 控制台的"服务管理" -> "服务列表"中，确认以下服务已注册：

    • ruoyi-system
    • ruoyi-manage

  2. 检查路由：访问以下 URL 验证路由是否正常：

    • http://localhost:8080/system/user/list - 系统模块用户列表
    • http://localhost:8080/manage/unit/archive/list - 管理模块单位建档列表
    • http://localhost:8080/ruoyi-system/v3/api-docs - 系统模块 Swagger 文档
    • http://localhost:8080/ruoyi-manage/v3/api-docs - 管理模块 Swagger 文档

  3. 检查 Swagger UI：

    • 访问：http://localhost:8080/swagger-ui.html 或 http://localhost:8080/doc.html
    • 在服务下拉列表中应该能看到 ruoyi-system 和 ruoyi-manage

注意事项

  • 如果启用了 discovery.locator.enabled: true，网关会自动为所有注册的服务创建路由，路径格式为：/服务名/**
  • 但为了更好的控制和明确的路由规则，建议显式配置路由
  • 路由配置修改后需要重启网关服务才能生效