diff --git a/backend-java/src/test/java/com/nanri/aiimage/config/ClientVersionGuardContextSliceTest.java b/backend-java/src/test/java/com/nanri/aiimage/config/ClientVersionGuardContextSliceTest.java new file mode 100644 index 000000000..c95468675 --- /dev/null +++ b/backend-java/src/test/java/com/nanri/aiimage/config/ClientVersionGuardContextSliceTest.java @@ -0,0 +1,163 @@ +package com.nanri.aiimage.config; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assertions.assertNotNull; +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.content; +import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status; + +import org.junit.jupiter.api.DisplayName; +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.autoconfigure.jackson.JacksonAutoConfiguration; +import org.springframework.boot.test.context.SpringBootTest; +import org.springframework.context.annotation.Configuration; +import org.springframework.web.servlet.config.annotation.EnableWebMvc; +import org.springframework.context.annotation.Import; +import org.springframework.http.MediaType; +import org.springframework.test.web.servlet.MockMvc; +import org.springframework.test.web.servlet.MvcResult; +import org.springframework.web.bind.annotation.GetMapping; +import org.springframework.web.bind.annotation.PostMapping; +import org.springframework.web.bind.annotation.RequestBody; +import org.springframework.web.bind.annotation.RequestHeader; +import org.springframework.web.bind.annotation.RestController; +import org.springframework.web.context.WebApplicationContext; + +/** + * 上下文装配切片(四面 9 分口径 §2 后端「4035 例全在 mock 边界内」那一格的补法)。 + * + *
为什么专门开这一支:本仓 4,035 个 {@code @Test} 全部在 mock 边界内跑——对象是 new 出来的、 + * {@code @Value} 是 ReflectionTestUtils 注进去的。那种写法证不了两件事,而这两件事恰好是 + * 版本硬地板能不能生效的前提:① 属性文件里的 {@code aiimage.client-version.*} 能不能绑进闸门; + * ② 闸门作为 bean 注册后,Spring Boot 会不会真的把它挂进 servlet 过滤器链、顺序对不对。 + * 上面任何一件坏掉,纯 mock 用例照样全绿,现网则是"闸门写了但没生效"。 + * + *
不连库:上下文里只有 MVC 与这一个闸门({@code SliceConfig} 手工装配,不扫描业务包、 + * 不加载 DataSource/MyBatis/Redis/RocketMQ),所以本机没有 Docker、没有 MySQL 也能跑 + * ——这正是任务书要求的形状("真库用例显式标注仅 CI/远端可跑,不许在本机做成恒绿闸门")。 + * + *
跑法:{@code mvn -o test -Dtest=ClientVersionGuardContextSliceTest}(cwd = backend-java)。 + * + *
真实的 SecurityConfig 也装进切片,而不是把它排除掉:现网里 CSRF 已关闭、路径全部 permitAll,安全链从不拦住客户端请求,而闸门是 {@code @Order(LOWEST_PRECEDENCE)},排在它之后。带上这一层,本切片跑的就是现网同一条过滤器链;换成 Boot 默认规则时 POST 被 CSRF 打成 403、GET 被匿名访问打成 401,闸门根本没机会执行——那种红与绿都不说明任何事。 + */ +@SpringBootTest( + classes = ClientVersionGuardContextSliceTest.SliceConfig.class, + webEnvironment = SpringBootTest.WebEnvironment.MOCK, + properties = { + "aiimage.client-version.min-supported-version=4.0.40", + "aiimage.client-version.enforce=true", + }) +@AutoConfigureMockMvc +class ClientVersionGuardContextSliceTest { + + @Autowired + private MockMvc mockMvc; + + @Autowired + private WebApplicationContext context; + + /** 只装 MVC + 被测闸门;被 @Import 的 PingController 提供一条客户端路径与一条非客户端路径。 */ + @Configuration(proxyBeanMethods = false) + @EnableWebMvc + @Import({ClientVersionGuardFilter.class, SecurityConfig.class, + SlicePingController.class, JacksonAutoConfiguration.class}) + static class SliceConfig { + } + + @RestController + static class SlicePingController { + + @PostMapping("/api/client/ping") + String clientPing(@RequestBody(required = false) String body, + @RequestHeader(value = "X-Client-Version", required = false) String version) { + return "PONG:" + (version == null ? "-" : version); + } + + @GetMapping("/api/admin/users") + String adminPath() { + return "ADMIN"; + } + } + + @Test + @DisplayName("闸门确实在容器里,且是 Spring 建的 bean(不是测试 new 出来的)") + void filterIsAContainerBean() { + ClientVersionGuardFilter filter = context.getBean(ClientVersionGuardFilter.class); + assertNotNull(filter, "闸门没进容器 ⇒ 下面三条断言全部失去意义"); + } + + @Test + @DisplayName("properties 里的地板值真被 @Value 绑定(纯 mock 用例证不到这一层)") + void floorComesFromProperties() throws Exception { + // 4.0.10 < 4.0.40:若属性没绑进闸门,minSupportedVersion 会是空串 ⇒ 闸门不配置 ⇒ 放行到 controller + MvcResult result = mockMvc.perform(post("/api/client/ping") + .contentType(MediaType.APPLICATION_JSON) + .header("X-Client-Version", "4.0.10") + .content("{}")) + .andExpect(status().isOk()) + .andReturn(); + String body = result.getResponse().getContentAsString(); + assertFalse(body.startsWith("PONG"), + "低版本客户端被放行了 ⇒ properties 没绑进闸门,或闸门不在过滤器链里:body=" + body); + assertTrue(body.contains("4012"), + "拒绝码不是 4012,本切片的判据与闸门实现脱节:" + body); + } + + @Test + @DisplayName("版本达标时过滤器放行,请求真的走到 controller") + void allowedVersionReachesController() throws Exception { + mockMvc.perform(post("/api/client/ping") + .contentType(MediaType.APPLICATION_JSON) + .header("X-Client-Version", "4.0.46") + .content("{}")) + .andExpect(status().isOk()) + .andExpect(content().string("PONG:4.0.46")); + } + + @Test + @DisplayName("未上报版本默认不拒(存量装机不受影响),仍走到 controller") + void unreportedIsSparedByDefault() throws Exception { + mockMvc.perform(post("/api/client/ping").contentType(MediaType.APPLICATION_JSON).content("{}")) + .andExpect(status().isOk()) + .andExpect(content().string("PONG:-")); + } + + @Test + @DisplayName("非客户端路径不参与判定(后台与内部令牌通道零影响)") + void nonClientPathUntouched() throws Exception { + mockMvc.perform(get("/api/admin/users").header("X-Client-Version", "0.0.1")) + .andExpect(status().isOk()) + .andExpect(content().string("ADMIN")); + } + + @Test + @DisplayName("拒绝形态是 200 + success=false + code 4012(与全仓业务拒绝口径一致)") + void rejectionKeepsAppConvention() throws Exception { + MvcResult result = mockMvc.perform(post("/api/client/ping") + .contentType(MediaType.APPLICATION_JSON) + .header("X-Client-Version", "3.9.9") + .content("{}")) + .andExpect(status().isOk()) + .andReturn(); + String body = result.getResponse().getContentAsString(); + assertEquals(Boolean.FALSE, parseSuccess(body), "业务拒绝必须写 success=false:" + body); + assertTrue(body.contains("minSupportedVersion"), + "响应体没带 minSupportedVersion,前端就无从提示升级:" + body); + } + + + /** 用字符串而不是 ObjectMapper:这条用例只关心形状,不想再引一层依赖。 */ + private static Boolean parseSuccess(String body) { + int idx = body.indexOf("\"success\""); + if (idx < 0) { + return null; + } + String tail = body.substring(idx).replace(" ", ""); + return tail.startsWith("\"success\":false") ? Boolean.FALSE : Boolean.TRUE; + } +}