身份认证与应用安全 / 系统课时
为认证链路补齐接口测试
为认证链路补齐接口测试
认证功能最容易出现“单个接口能用,但组合流程回归失败”的问题。本篇把登录、鉴权、退出和踢下线整理成一组可重复执行的集成测试,让 Token 传递、路由拦截、权限加载和会话失效都进入自动化回归范围。
学习目标
- 为六类关键认证场景定义稳定的接口测试契约
- 使用
MockMvc驱动真实 Sa-Token 认证链路,而不是只 MockStpUtil - 验证主动退出和踢下线后旧 Token 都不能继续访问受保护资源
先固定接口契约
测试不应依赖“异常消息里刚好出现某几个字”。先由应用自己的全局异常处理固定 HTTP 状态码,再让测试断言状态和关键业务字段。下面采用一套示例契约,实际项目可以替换路径与返回体,但应保持场景覆盖完整。
| 场景 | 操作 | 期望 |
|---|---|---|
| 登录成功 | 正确账号密码调用 /api/auth/login |
200,返回非空 tokenValue |
| 密码错误 | 错误密码登录 | 401 |
| 未登录访问 | 不带 Token 调用 /api/profile |
401 |
| 权限不足 | 普通账号访问 /api/admin/audit |
403 |
| 主动退出 | 登录后调用 /api/auth/logout,再复用旧 Token |
退出成功,旧 Token 再访问为 401 |
| 被踢下线 | 登录后执行 kickout,再复用旧 Token |
旧 Token 再访问为 401 |
这里的 401、403、204 是应用层约定,不是要求 Sa-Token 必须默认返回这些 HTTP 状态;关键是让异常处理与测试使用同一份契约。Sa-Token 的登录校验失败会通过 NotLoginException 表达,权限校验失败则通过权限异常表达,应用可以统一转换成自己的接口协议。([Sa-Token][5])
用真实 Web 上下文覆盖认证链路
下面是片段示例:它依赖一个现有 Spring Boot 项目,并约定 alice/alice-pass 对应登录账号 1001,viewer/viewer-pass 能登录但没有管理权限;登录成功直接返回 {"tokenValue":"..."}。测试使用真实 MockMvc 请求和 Sa-Token 会话状态,因此可以同时发现拦截器、Token 传递和权限加载问题。
package com.example.auth;
import cn.dev33.satoken.stp.StpUtil;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.junit.jupiter.api.AfterEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.http.MediaType;
import org.springframework.test.web.servlet.MockMvc;
import static org.assertj.core.api.Assertions.assertThat;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
@SpringBootTest
@AutoConfigureMockMvc
class AuthFlowIT {
@Autowired
MockMvc mvc;
@Autowired
ObjectMapper objectMapper;
@AfterEach
void cleanup() {
// 避免一个测试创建的账号会话污染后续测试。
StpUtil.logout(1001L);
StpUtil.logout(2001L);
}
@Test
void loginSuccess() throws Exception {
assertThat(login("alice", "alice-pass")).isNotBlank();
}
@Test
void wrongPasswordIsRejected() throws Exception {
mvc.perform(post("/api/auth/login")
.contentType(MediaType.APPLICATION_JSON)
.content("{\"username\":\"alice\",\"password\":\"wrong\"}"))
.andExpect(status().isUnauthorized());
}
@Test
void anonymousRequestIsRejected() throws Exception {
mvc.perform(get("/api/profile"))
.andExpect(status().isUnauthorized());
}
@Test
void insufficientPermissionIsRejected() throws Exception {
String token = login("viewer", "viewer-pass");
mvc.perform(get("/api/admin/audit")
.header(StpUtil.getTokenName(), token))
.andExpect(status().isForbidden());
}
@Test
void logoutInvalidatesOldToken() throws Exception {
String token = login("alice", "alice-pass");
mvc.perform(post("/api/auth/logout")
.header(StpUtil.getTokenName(), token))
.andExpect(status().isNoContent());
mvc.perform(get("/api/profile")
.header(StpUtil.getTokenName(), token))
.andExpect(status().isUnauthorized());
}
@Test
void kickoutInvalidatesOldToken() throws Exception {
String token = login("alice", "alice-pass");
// kickout 按账号使现有登录失效,随后仍用旧 Token 发起真实请求。
StpUtil.kickout(1001L);
mvc.perform(get("/api/profile")
.header(StpUtil.getTokenName(), token))
.andExpect(status().isUnauthorized());
}
private String login(String username, String password) throws Exception {
String requestBody = objectMapper.writeValueAsString(
new LoginRequest(username, password)
);
String responseBody = mvc.perform(post("/api/auth/login")
.contentType(MediaType.APPLICATION_JSON)
.content(requestBody))
.andExpect(status().isOk())
.andReturn()
.getResponse()
.getContentAsString();
return objectMapper.readTree(responseBody)
.path("tokenValue")
.asText();
}
record LoginRequest(String username, String password) {
}
}StpUtil.logout(loginId) 与 StpUtil.kickout(loginId) 都是当前 Sa-Token 提供的账号级会话操作,适合在测试中清理或构造失效状态。踢下线与普通注销的语义并不相同,因此两条回归用例应分开保留。([GitHub][6])
执行并检查结果
如果项目使用 Maven Wrapper,可以只运行这一个集成测试类:
./mvnw -Dtest=AuthFlowIT test预期输出
Tests run: 6, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS如果某条失败,不要立刻放宽断言。登录成功测试失败时先检查接口契约;未登录测试失败时检查拦截范围;权限不足测试失败时检查 StpInterface;退出或踢下线测试失败时检查旧 Token 是否仍被读取为有效登录。
让测试具备长期回归价值
认证测试要避免三个常见陷阱:不要把 StpUtil.checkLogin() 或 checkPermission() 直接 Mock 掉,否则测不到真实拦截链路;不要依赖随机测试顺序,账号会话应在每个用例后清理;不要只断言登录接口本身,必须拿登录得到的 Token 再访问受保护资源。
对 Redis 会话或分布式部署项目,可以在这六条基础用例通过后,再增加“跨实例使用同一 Token”和“会话存储不可用”场景。基础回归的最低标准仍是:成功登录可访问、非法登录被拒绝、无 Token 被拒绝、无权限被拒绝、退出后旧 Token 失效、被踢后旧 Token 失效。