若依微服务版（RuoYi-Cloud）本地开发环境搭建后，如何快速验证核心功能是否正常？
若依微服务版（RuoYi-Cloud）核心功能快速验证指南
当你完成了RuoYi-Cloud本地开发环境的搭建，看到各个服务成功启动的日志后，可能依然会心存疑虑：系统真的跑通了吗？各模块之间的协作是否正常？本文将带你通过一系列快速验证步骤，确保核心功能链路完整可用，为后续开发奠定坚实基础。
1. 服务注册状态检查
在微服务架构中，服务注册中心是系统正常运转的基石。打开浏览器访问Nacos控制台（默认地址为http://localhost:8848/nacos，账号密码均为nacos），在服务管理 > 服务列表中，你应该能看到以下关键服务已成功注册：
- ruoyi-gateway：API网关服务
- ruoyi-auth：认证授权服务
- ruoyi-system：系统管理服务
注意：如果发现某个服务缺失，首先检查该服务的启动日志是否有报错，其次确认bootstrap.yml中的Nacos配置地址是否正确。
服务健康状态可通过颜色标识快速判断：
| 服务名称 | 健康实例数 | 状态标识 | 可能问题 |
|---|---|---|---|
| ruoyi-gateway | 1/1 | 绿色 | 正常 |
| ruoyi-auth | 0/1 | 红色 | 检查Redis连接 |
| ruoyi-system | 1/1 | 黄色 | 数据库连接不稳定 |
2. 认证授权链路验证
认证模块是系统安全的门户，我们通过模拟登录流程来测试整个鉴权链路是否通畅。
2.1 获取访问令牌
使用Postman或curl发送以下请求：
curl -X POST 'http://localhost:8080/auth/oauth/token' \ -H 'Authorization: Basic cnVveWk6MTIzNDU2' \ -H 'Content-Type: application/x-www-form-urlencoded' \ -d 'username=admin&password=admin123&grant_type=password'正常响应应包含access_token字段：
{ "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "token_type": "bearer", "expires_in": 43199 }2.2 令牌解析验证
将获取到的token通过JWT.io等工具解码，确认包含以下关键声明：
- user_name：当前登录用户名（如admin）
- authorities：用户权限列表
- client_id：客户端标识（应为ruoyi）
提示：若认证失败，重点检查ruoyi-auth服务的Redis配置是否正确，以及ruoyi-gateway的路由规则是否生效。
3. 业务功能接口测试
通过系统管理模块验证服务间调用和数据库交互是否正常。
3.1 用户列表查询
使用上一步获取的token测试系统接口：
curl -X GET 'http://localhost:8080/system/user/list?pageNum=1&pageSize=10' \ -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'预期返回数据结构应包含：
- rows：用户对象数组
- total：总记录数
- code：200（成功状态码）
常见问题排查表：
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 返回401未授权 | 1. Token过期 2. 网关路由配置错误 | 1. 重新获取token 2. 检查gateway路由规则 |
| 返回500服务器错误 | 1. 数据库连接异常 2. 服务未启动 | 1. 检查system服务数据库配置 2. 确认system服务状态 |
| 返回404找不到接口 | 1. 请求路径错误 2. 网关未注册 | 1. 核对接口文档 2. 检查gateway服务注册 |
3.2 菜单权限验证
测试权限控制是否生效：
# 管理员权限接口 curl -X GET 'http://localhost:8080/system/menu/list' \ -H 'Authorization: Bearer eyJhbGci...' # 普通用户权限接口（使用test用户token） curl -X GET 'http://localhost:8080/system/menu/list' \ -H 'Authorization: Bearer xeyJhbGci...'应观察到：
- 管理员可获取完整菜单树
- 普通用户只能看到授权菜单
- 未授权访问返回403状态码
4. 前端联调验证
启动前端服务（默认运行在80端口），通过UI操作验证全链路功能。
4.1 登录流程测试
在浏览器访问http://localhost，尝试以下操作序列：
- 输入错误密码（如admin/123456）→ 应显示"用户不存在/密码错误"
- 输入正确凭证（admin/admin123）→ 应跳转至首页
- 检查顶部菜单栏→ 应显示完整系统菜单
- 点击"系统管理 > 用户管理"→ 应加载用户数据表格
4.2 功能点快速检查清单
完成以下关键操作验证：
- [ ] 用户管理：新增/编辑/删除用户
- [ ] 角色管理：权限分配
- [ ] 菜单管理：动态路由配置
- [ ] 部门管理：树形结构展示
- [ ] 字典管理：数据缓存生效
- [ ] 操作日志：记录查询
5. 深度健康检查
对于准备投入生产的开发者，建议进行以下进阶验证：
5.1 服务熔断测试
模拟system服务不可用场景：
- 停止ruoyi-system服务
- 重复调用用户列表接口
- 观察gateway是否返回合理的熔断响应
5.2 性能基准测试
使用JMeter等工具进行简单压测：
线程组配置： - 线程数：50 - 循环次数：100 - 目标接口：/system/user/list 监控指标： - 平均响应时间 < 500ms - 错误率 < 0.1% - 吞吐量 > 100 req/s5.3 数据一致性验证
测试分布式事务场景：
- 创建新用户并分配角色
- 在角色分配阶段强制断开数据库连接
- 检查用户表与角色关联表是否保持原子性
在实际项目中，我们发现当Redis配置超时时间过短时，频繁的token验证请求会导致auth服务响应延迟。建议将Redis的timeout参数调整为30秒以上，同时适当增加连接池大小。