Spring Boot Test与MockMvc上下文创建及关联接口测试最佳实践

1. 拆分测试类型：单元测试与集成/流程测试分离 #

• 单元测试：严格遵循JUnit 5的命名规范，每个控制器对应单独的测试类（如AuthLoginControllerTest、AuthLogoutControllerTest），聚焦单个接口的独立逻辑。比如测试登出接口时，直接使用模拟的有效JWT令牌（可通过工具生成固定令牌，或用@MockBean模拟认证服务），无需依赖真实登录接口的返回，保证测试的独立性和执行速度。
• 集成/流程测试：单独创建不绑定单个控制器的测试类（如AuthFlowIntegrationTest），专门验证登录-登出、授权-资源访问这类跨接口的完整业务流程。这类测试以业务场景为核心命名，不用局限于单个控制器的命名规则，目的是验证多组件协作的正确性。

2. 利用JUnit 5扩展机制共享流程状态 #

如果需要在同一测试类中串联流程（比如先登录再登出），可以用@TestInstance(TestInstance.Lifecycle.PER_CLASS)注解让测试类实例仅创建一次，在@BeforeAll或@BeforeEach方法中提前完成登录并保存JWT，供后续测试方法调用。示例代码：

@TestInstance(TestInstance.Lifecycle.PER_CLASS)
class AuthFlowIntegrationTest {
    private String validJwt;

    @Autowired
    private MockMvc mockMvc;

    @BeforeAll
    void setup() throws Exception {
        // 调用登录接口获取并保存JWT
        MvcResult result = mockMvc.perform(post("/auth/login")
                .contentType(MediaType.APPLICATION_JSON)
                .content("{\"username\":\"test\",\"password\":\"123456\"}"))
                .andExpect(status().isOk())
                .andReturn();
        validJwt = result.getResponse().getContentAsString();
    }

    @Test
    void loginAndLogoutFlow() throws Exception {
        // 使用保存的JWT调用登出接口
        mockMvc.perform(post("/auth/logout")
                .header("Authorization", "Bearer " + validJwt))
                .andExpect(status().isOk());
    }
}

注意：这种方式仅适用于流程测试，单元测试不要使用，避免测试间的依赖导致结果不稳定。

3. 避免全局Map这类共享状态方案 #

全局Map或应用上下文存储状态的方式不推荐，会导致测试耦合度高、并行测试失败（状态共享冲突），且不利于后续维护。一旦某个测试修改了全局状态，其他测试的结果会变得不可控。

4. 封装通用操作到测试工具类 #

创建AuthTestUtils这类工具类，封装登录获取JWT的通用逻辑，在需要的测试类中直接调用，减少重复代码。示例：

public class AuthTestUtils {
    public static String getValidJwt(MockMvc mockMvc) throws Exception {
        MvcResult result = mockMvc.perform(post("/auth/login")
                .contentType(MediaType.APPLICATION_JSON)
                .content("{\"username\":\"test\",\"password\":\"123456\"}"))
                .andExpect(status().isOk())
                .andReturn();
        return result.getResponse().getContentAsString();
    }
}

这样在登出的集成测试中，可直接调用该方法获取JWT，无需依赖登录测试类。

内容的提问来源于stack exchange，提问作者e-info128