身份认证与应用安全 / 系统课时

为认证链路补齐接口测试

为认证链路补齐接口测试

认证功能最容易出现“单个接口能用,但组合流程回归失败”的问题。本篇把登录、鉴权、退出和踢下线整理成一组可重复执行的集成测试,让 Token 传递、路由拦截、权限加载和会话失效都进入自动化回归范围。

学习目标

  • 为六类关键认证场景定义稳定的接口测试契约
  • 使用 MockMvc 驱动真实 Sa-Token 认证链路,而不是只 Mock StpUtil
  • 验证主动退出和踢下线后旧 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 传递和权限加载问题。

java
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,可以只运行这一个集成测试类:

bash
./mvnw -Dtest=AuthFlowIT test

预期输出

text
Tests run: 6, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS

如果某条失败,不要立刻放宽断言。登录成功测试失败时先检查接口契约;未登录测试失败时检查拦截范围;权限不足测试失败时检查 StpInterface;退出或踢下线测试失败时检查旧 Token 是否仍被读取为有效登录。

让测试具备长期回归价值

认证测试要避免三个常见陷阱:不要把 StpUtil.checkLogin() 或 checkPermission() 直接 Mock 掉,否则测不到真实拦截链路;不要依赖随机测试顺序,账号会话应在每个用例后清理;不要只断言登录接口本身,必须拿登录得到的 Token 再访问受保护资源。

对 Redis 会话或分布式部署项目,可以在这六条基础用例通过后,再增加“跨实例使用同一 Token”和“会话存储不可用”场景。基础回归的最低标准仍是:成功登录可访问、非法登录被拒绝、无 Token 被拒绝、无权限被拒绝、退出后旧 Token 失效、被踢后旧 Token 失效。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

为认证链路补齐接口测试

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通