若依框架接口测试实战：从登录验证到用户列表查询

原创

于 2026-02-19 01:24:40 发布 · 190 阅读

标签

#若依 #接口测试 #自动化测试 #API调试

1. 环境准备与工具选择：为实战打下坚实基础

在开始动手测试若依框架的接口之前，花点时间把环境和工具准备好，绝对是磨刀不误砍柴工。我自己在带团队或者做项目的时候，发现很多新手一上来就急着调接口，结果在环境配置上卡半天，非常影响效率。所以，我们先来把“战场”布置好。

首先，你得有一个正在运行的若依后端服务。这听起来像是废话，但我确实见过有人拿着接口文档就开始在 Apifox 里戳，完全忘了后端服务还没启动。若依框架的启动很简单，如果你是下载的官方前后端分离版本（RuoYi-Vue），那么后端通常是一个标准的 Spring Boot 项目。用 IDEA 或者 Eclipse 打开后端项目，找到主启动类（一般是 RuoYiApplication.java），直接运行就行。默认情况下，它会使用 application.yml 里的配置启动。你需要确认一下配置文件里的服务器地址和端口，最常见的就是 localhost:8080 或者 localhost:8081。启动成功后，在浏览器里访问一下 http://localhost:8081/（或者你的端口），如果能看到一些简单的欢迎信息或者 Swagger 文档页面，那就说明后端服务已经正常跑起来了。

接下来是重头戏：接口测试工具。市面上工具很多，Postman、Apifox、ApiPost 等等。我这里强烈推荐使用 Apifox。为什么？因为它对国内开发者太友好了。Postman 虽然强大，但全英文界面，对新手有点门槛，而且网络同步有时候不太稳定。Apifox 是国产的，界面清晰，功能整合得非常好，它把 API 文档、调试、Mock 数据和自动化测试都做到了一起。你不需要在好几个工具之间来回切换，一个 Apifox 就能搞定从接口调试到生成测试报告的全流程。对于若依这种自带 Swagger 文档的项目，Apifox 还能一键导入所有接口，省去你一个个手动录入的麻烦，这个功能我们后面会详细说。

除了 Apifox，我们还需要一个工具来查看 Redis。因为若依的登录验证码是存在 Redis 里的，测试登录时我们需要从 Redis 里拿到正确的验证码。如果你本地安装了 Redis，可以用 Redis 桌面管理工具，比如 Redis Desktop Manager 或者 Another Redis Desktop Manager，它们图形化界面操作起来很直观。当然，如果你习惯命令行，用 redis-cli 也可以。确保你的 Redis 服务已经启动，并且和若依项目连接的是同一个 Redis 实例（通常配置在 application.yml 的 spring.redis 节点下）。

最后，准备一个趁手的文本编辑器，用来临时记录一些关键信息，比如 uuid、token。浏览器的开发者工具（F12打开）的 Console 或 Network 标签页也会是你的好帮手。环境齐备，工具在手，我们就可以正式开始若依接口测试的闯关之旅了，第一关就是最经典的：登录验证。

2. 登录验证全流程拆解：搞定最难缠的验证码

登录接口往往是测试中最先碰到，也最容易卡住的一环。若依的登录流程设计得比较典型，包含了图片验证码校验，这比单纯的用户名密码验证多了一步，也更安全。我们一步步把它拆解开，你会发现其实一点也不复杂。

2.1 第一步：获取验证码图片与关键UUID

登录的第一步不是直接发送用户名密码，而是先获取验证码。这里有个关键点：验证码不是凭空生成的，它是一次性会话的凭证。服务器生成验证码图片的同时，会在后端（通常是Redis）保存这个验证码的正确答案，并且给你一个唯一的“票据”（uuid），你后续提交登录请求时，必须把这个“票据”和用户输入的验证码一起送回服务器，服务器才能核对。

我们来调用这个接口：GET http://localhost:8081/captchaImage。用 Apifox 新建一个请求，方法选 GET，地址填好，直接发送。

你会得到一个 JSON 格式的响应，大概长这样：

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "captchaEnabled": true,
    "uuid": "f4a8c7b2e1d34a5897f6c0d3b21a9e8f",
    "img": "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7"
  }
}

这个响应体里信息