MockMvc 接口测试

这一课你将能做到

1. 用 MockMvc.perform 发送 GET/POST，断言状态码与 jsonPath 字段，把接口契约测到字段级
2. 为判题接口「提交成功 / 非法语言 / 未登录」各写一条可读的用例，并验证统一错误体形状
3. 说清 MockMvc、纯 Mockito 单测、E2E 三者的分工边界

为什么要学

接口契约是前后端的合同：状态码、JSON 字段名、错误体形状。platform（Next.js）正是按这份合同写解析代码的——backend 悄悄把 message 改成 msg，前端整片红色报错。人话：MockMvc 是不启真实端口、不启浏览器的 HTTP 模拟器——请求打进 DispatcherServlet，断言响应长什么样。

它比 Playwright 快一个数量级，比纯 Service 单测更接近「前端实际会收到什么」。本站 GlobalExceptionHandler 把 BusinessException 按状态码翻译、未登录翻成 401——这些「HTTP 外观」逻辑只有 MockMvc 这一层能守护。Node 侧的近亲是 supertest（见 node-test），思想一致：对 HTTP 层做黑盒断言。

先建立图像

browser / curl ──HTTP──► Tomcat 真实端口 ──► Controller
MockMvc      ──模拟HTTP──► DispatcherServlet ──► Controller
                              ▲
                        不占 8080，不启网络栈

配合 @MockitoBean Service + mockStatic(StpUtil)
→ 只验证「Web 层翻译」：路由、校验、序列化、异常→状态码

场景	工具
Service 业务分支	JUnit + Mockito（第 3 课）
HTTP 契约、状态码、JSON	MockMvc（本课）
真 DB + 真 SQL	@SpringBootTest + Testcontainers（第 6 课）
真实浏览器路径	Playwright（第 9 课）

跟着做

步骤 1：判题接口的 happy path（POST + jsonPath）

沿用上一课的切片骨架：

@WebMvcTest(SubmissionController.class)
class SubmissionContractTest {

    @Autowired MockMvc mockMvc;
    @MockitoBean SubmissionService submissionService;

    @Test
    void 提交成功返回200与记录字段() throws Exception {
        try (MockedStatic<StpUtil> stp = mockStatic(StpUtil.class)) {
            stp.when(StpUtil::getLoginIdAsLong).thenReturn(3L);

            Submission s = new Submission();
            s.setId(10L);
            s.setUserId(3L);
            s.setLessonId(5L);
            s.setLanguage("java");
            s.setCode("class A {}");
            s.setStatus("pending");
            when(submissionService.submit(3L, 5L, "java", "class A {}"))
                .thenReturn(s);

            mockMvc.perform(post("/submissions")
                    .contentType(MediaType.APPLICATION_JSON)
                    .content("""
                        {"lessonId":5,"language":"java","code":"class A {}"}
                        """))
                .andExpect(status().isOk())
                .andExpect(content().contentTypeCompatibleWith(MediaType.APPLICATION_JSON))
                .andExpect(jsonPath("$.id").value(10))
                .andExpect(jsonPath("$.status").value("pending"))
                .andExpect(jsonPath("$.userId").value(3));
        }
    }
}