瀏覽代碼

test(xiaomi.health.miniapp): S-cfc-413 契约级RED单测 小程序端小米集成(F1-F4+B1后端小修 方案v1.4§13)

能力键:xiaomi.health.miniapp(方案 v1.4 §13.0-13.5,87e9d7dfa;后端 X1-X5 已合入 4344688d2)。
纯 Mockito/反射结构+行为契约,无 Spring/DB/外部服务。预期红:3 失败 / 9 通过 / 0 错误。
契约锚点:
- §13.1 五接口路径/@PostMapping 与响应字段契约(authUrl/mode/redirectUri/state/scope、bound/status/expiresAt、syncAt/result|results、revoked、bound/channel/mock/configured/expiresAt/scope)——已落地,绿。
- §13.4-4 callback 缺失 code→400 行为保持——已存在,绿。
- §13.3/13.4-4 state 校验(防 CSRF)锚点缺失——红。
- §13.1/13.4-2 auth-url mock 模式缺 state 字段(buildAuthUrl mock 分支)——红。
- §13.3 redirect-uri 默认值仍为 /api/xiaomi-health/callback(未改 H5 中转页 xiaomi-cb.html)——红。
GREEN 指引见类注释;实现仅在 task 分支推进,不假定包路径。
Administrator 1 天之前
父節點
當前提交
b1a5423f8b
共有 1 個文件被更改,包括 476 次插入 和 0 次删除
  1. 476 0
      cfc-backend/src/test/java/com/etotem/cfc/unit/XiaomiHealthMiniappContractTest.java

+ 476 - 0
cfc-backend/src/test/java/com/etotem/cfc/unit/XiaomiHealthMiniappContractTest.java

@@ -0,0 +1,476 @@
+package com.etotem.cfc.unit;
+
+import com.alibaba.fastjson.JSONObject;
+import com.etotem.cfc.common.Result;
+import com.etotem.cfc.controller.xiaomi.XiaomiHealthController;
+import com.etotem.cfc.entity.XiaomiHealthToken;
+import com.etotem.cfc.service.XiaomiAuthService;
+import com.etotem.cfc.service.xiaomi.XiaomiHealthService;
+import com.etotem.cfc.service.xiaomi.XiaomiSyncResult;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.DisplayName;
+import org.junit.jupiter.api.Test;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.MockitoAnnotations;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+import java.io.InputStream;
+import java.lang.reflect.Field;
+import java.lang.reflect.Method;
+import java.lang.reflect.Modifier;
+import java.nio.charset.StandardCharsets;
+import java.util.*;
+
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyLong;
+import static org.mockito.ArgumentMatchers.anyString;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.*;
+
+/**
+ * 契约级单测:小程序端小米运动健康集成(能力键 {@code xiaomi.health.miniapp})。
+ *
+ * <p><b>契约来源</b>(方案 v1.4 §13,提交 {@code 87e9d7dfa} 已合入 origin/cfclub):
+ * <blockquote>
+ *   §13.0 用户拍板(2026-11-16):应用名 <b>cfc</b>、不建 Android 手机应用、集成落在 <b>现有 cfclub 小程序内</b>。
+ *   §13.1 接口契约(后端已就绪,前端直接调用;JWT 拦截 {@code /api/**},全 {@code @PostMapping}):
+ *   <ol>
+ *     <li>{@code POST /api/xiaomi-health/auth-url} 获取授权 URL:入参 {@code memberId?},出参 {@code authUrl/mode/redirectUri/state/scope}</li>
+ *     <li>{@code POST /api/xiaomi-health/callback} 授权回调:入参 {@code code/memberId?},出参 {@code bound/status/expiresAt}</li>
+ *     <li>{@code POST /api/xiaomi-health/sync} 触发同步:入参 {@code memberId?/dataType?},出参 {@code syncAt + result/results}</li>
+ *     <li>{@code POST /api/xiaomi-health/revoke} 撤销授权:入参 {@code memberId?},出参 {@code revoked}</li>
+ *     <li>{@code POST /api/xiaomi-health/status} 状态查询:入参 {@code memberId?},出参 {@code bound/channel/mock/configured/expiresAt/scope}</li>
+ *   </ol>
+ *   §13.3 OAuth web 回调中转(B1,后端静态层小改):
+ *   <ul>
+ *     <li>redirect-uri 默认值改为 H5 中转页({@code xiaomi-cb.html}),旧值 {@code /api/xiaomi-health/callback} 不可用</li>
+ *     <li>state 校验(防 CSRF)在 callback 链路补齐</li>
+ *   </ul>
+ *   §13.4 验收标准(后端小修 RED→YELLOW→GREEN):
+ *   <ol>
+ *     <li>契约一致:api.js 5 方法字段与 13.1 逐一致</li>
+ *     <li>state 校验 + callback 缺失 code 返回 400 行为保持</li>
+ *   </ol>
+ * </blockquote></p>
+ *
+ * <p><b>平台现状(origin/cfclub src/main 探测)</b>:
+ * <ul>
+ *   <li>5 个接口路径/方法/响应字段契约(§13.1)已落地(XiaomiHealthController + XiaomiAuthService + XiaomiHealthService,X1-X5 已合入 {@code 4344688d2});</li>
+ *   <li><b>缺失(红):</b>
+ *   <ul>
+ *     <li>callback 链路无 state 校验:{@code XiaomiHealthController.callback} 仅读 code/memberId(全文件无 state 参数);{@code XiaomiAuthService} 无 state 校验方法/常量(§13.3/13.4-4)。</li>
+ *     <li>auth-url mock 模式缺 state 字段:{@code XiaomiAuthService.buildAuthUrl} mock 分支返回的 map 无 {@code "state"} 键(仅 URL 内嵌),与 §13.1 契约不一致(§13.4-2)。</li>
+ *     <li>application.yml redirect-uri 默认值仍为 {@code https://cfc.etotem.com.cn/api/xiaomi-health/callback}(§13.3 要求改为 H5 中转页 {@code xiaomi-cb.html})。</li>
+ *   </ul>
+ *   </li>
+ *   <li>callback 缺失 code → 400 行为已存在(§13.4-4 行为保持)。</li>
+ * </ul>
+ * 因此本测试以「反射结构契约 + Mockito 行为契约」探测上述缺失:能编译、能运行、断言失败(红)。</p>
+ *
+ * <p><b>GREEN 升级指引</b>:
+ * <ol>
+ *   <li><b>state 校验(§13.3/13.4-4)</b>:{@code XiaomiHealthController.callback} 读取 {@code state} 参数并校验(格式 {@code member-<memberId>-<ts>});{@code XiaomiAuthService} 新增 {@code validateState} 方法/常量锚点。GREEN 时 mock/real 双模式均校验 state 缺失/不匹配 → 拒绝换 token(Result.badRequest)。</li>
+ *   <li><b>mock 模式 state 字段(§13.1/13.4-2)</b>:{@code buildAuthUrl} mock 分支补 {@code result.put("state", state)}。</li>
+ *   <li><b>redirect-uri 默认值(§13.3)</b>:application.yml {@code xiaomi.health.redirect-uri} 默认值改为 H5 中转页(含 {@code xiaomi-cb} 标识)。</li>
+ *   <li>届时可将结构探测升级为行为级 mock 验证(verify(xiaomiAuthService).validateState(...) / assertResult.containsKey("state"))。</li>
+ * </ol></p>
+ *
+ * <p><b>权限流说明</b>:本能力为小程序端 OAuth 授权 + 数据同步,无新增用户权限维度;
+ * JWT 拦截 {@code /api/**} 已在现有 {@code JwtInterceptor} 中(登录态由后端统一鉴权),
+ * 权限流不适用,以说明性用例标注。</p>
+ *
+ * <p><b>预期结果</b>:<b>3 失败 / 9 通过 / 0 错误</b>(RED:callback 链路 state 校验锚点缺失、auth-url mock 模式缺 state 字段、
+ * redirect-uri 默认值未改 H5 中转页)。</p>
+ */
+class XiaomiHealthMiniappContractTest {
+
+    // ------------------------------------------------------------------
+    // 契约锚点常量
+    // ------------------------------------------------------------------
+
+    /** §13.1 接口基础路径 */
+    private static final String BASE_PATH = "/api/xiaomi-health";
+
+    /** §13.1 5 个子路径 */
+    private static final String[] EXPECTED_PATHS = {"/auth-url", "/callback", "/sync", "/revoke", "/status"};
+
+    /** §13.1 auth-url 响应键 */
+    private static final String[] AUTH_URL_KEYS = {"authUrl", "mode", "redirectUri", "state", "scope"};
+
+    /** §13.1 callback 响应键 */
+    private static final String[] CALLBACK_KEYS = {"bound", "status", "expiresAt"};
+
+    /** §13.1 sync 单类型响应键 */
+    private static final String[] SYNC_SINGLE_KEYS = {"syncAt", "dataType", "result"};
+
+    /** §13.1 sync 全量响应键 */
+    private static final String[] SYNC_ALL_KEYS = {"syncAt", "results"};
+
+    /** §13.1 revoke 响应键 */
+    private static final String[] REVOKE_KEYS = {"revoked"};
+
+    /** §13.1 status 响应键 */
+    private static final String[] STATUS_KEYS = {"bound", "channel", "mock", "configured", "expiresAt", "scope"};
+
+    /** §13.3/13.4-4 state 校验锚点:state 关键字 */
+    private static final String STATE_KEY = "state";
+
+    /** §13.3 redirect-uri H5 中转页标识 */
+    private static final String RELAY_PAGE_MARKER = "xiaomi-cb";
+
+    /** §13.3 旧 redirect-uri 路径(不可用) */
+    private static final String OLD_REDIRECT_PATH = "/api/xiaomi-health/callback";
+
+    /** 控制器类名(§13.1/13.3 落点) */
+    private static final String CONTROLLER_CLASS = "com.etotem.cfc.controller.xiaomi.XiaomiHealthController";
+
+    /** 认证服务类名(§13.3 落点) */
+    private static final String AUTH_SERVICE_CLASS = "com.etotem.cfc.service.XiaomiAuthService";
+
+    /** 同步服务类名(接口,§13.1 落点) */
+    private static final String SYNC_SERVICE_CLASS = "com.etotem.cfc.service.xiaomi.XiaomiHealthService";
+
+    // ------------------------------------------------------------------
+    // Mock 注入(行为契约测试)
+    // ------------------------------------------------------------------
+
+    @Mock
+    private XiaomiAuthService xiaomiAuthService;
+
+    @Mock
+    private XiaomiHealthService xiaomiHealthService;
+
+    @InjectMocks
+    private XiaomiHealthController controller;
+
+    @BeforeEach
+    void setUp() {
+        MockitoAnnotations.openMocks(this);
+    }
+
+    // ==================== 正常流:5 个接口路由结构契约(GREEN) ====================
+
+    @Test
+    @DisplayName("正常流-1:5 个接口路径全为 @PostMapping 且挂在 /api/xiaomi-health 下")
+    void fiveEndpoints_allPostMappingUnderBasePath() {
+        Class<?> clazz = loadClass(CONTROLLER_CLASS);
+        assertNotNull(clazz, CONTROLLER_CLASS + " 不存在");
+
+        RequestMapping rm = clazz.getAnnotation(RequestMapping.class);
+        assertNotNull(rm, CONTROLLER_CLASS + " 缺少 @RequestMapping");
+        String base = rm.value().length > 0 ? rm.value()[0] : "";
+        assertEquals(BASE_PATH, base, "基础路径应为 " + BASE_PATH);
+
+        Set<String> found = new HashSet<>();
+        for (Method m : clazz.getDeclaredMethods()) {
+            PostMapping pm = m.getAnnotation(PostMapping.class);
+            if (pm != null) {
+                for (String v : pm.value()) {
+                    found.add(v);
+                }
+            }
+        }
+        Set<String> expected = new HashSet<>(Arrays.asList(EXPECTED_PATHS));
+        assertEquals(expected, found,
+                "应仅包含 5 个子路径:" + expected + ",实际:" + found);
+    }
+
+    // ==================== 正常流:5 个接口响应字段契约(GREEN) ====================
+
+    @Test
+    @DisplayName("正常流-2:auth-url 响应透传 §13.1 契约字段")
+    void authUrl_contractFieldsPassthrough() {
+        Map<String, Object> built = new LinkedHashMap<>();
+        built.put("authUrl", "https://auth.example.com/authorize?state=member-5-123");
+        built.put("mode", "real");
+        built.put("redirectUri", "https://cfc.etotem.com.cn/xiaomi-cb.html");
+        built.put("state", "member-5-123");
+        built.put("message", "ok");
+        when(xiaomiAuthService.buildAuthUrl(anyLong())).thenReturn(built);
+
+        Result<Map<String, Object>> resp = controller.authUrl(params("memberId", 5L), null);
+
+        assertEquals(200, resp.getCode());
+        Map<String, Object> data = resp.getData();
+        assertNotNull(data);
+        for (String key : AUTH_URL_KEYS) {
+            assertTrue(data.containsKey(key), "auth-url 响应应包含 " + key + "(§13.1)");
+        }
+        assertEquals(5L, data.get("memberId"));
+        assertEquals("real", data.get("mode"));
+    }
+
+    @Test
+    @DisplayName("正常流-3:callback 响应透传 §13.1 契约字段")
+    void callback_contractFieldsPassthrough() {
+        XiaomiHealthToken token = mock(XiaomiHealthToken.class);
+        when(token.getExpiresAt()).thenReturn(new Date());
+        when(xiaomiAuthService.exchangeCode(anyString(), anyLong())).thenReturn(token);
+
+        Result<Map<String, Object>> resp = controller.callback(params("code", "auth-code-123", "memberId", 5L), null);
+
+        assertEquals(200, resp.getCode());
+        Map<String, Object> data = resp.getData();
+        assertNotNull(data);
+        for (String key : CALLBACK_KEYS) {
+            assertTrue(data.containsKey(key), "callback 响应应包含 " + key + "(§13.1)");
+        }
+        assertEquals(true, data.get("bound"));
+        assertEquals("bound", data.get("status"));
+        assertNotNull(data.get("expiresAt"));
+    }
+
+    @Test
+    @DisplayName("正常流-4:sync 单类型响应透传 §13.1 契约字段")
+    void syncSingleType_contractFieldsPassthrough() {
+        XiaomiSyncResult ok = new XiaomiSyncResult();
+        ok.setSuccess(true);
+        ok.setDataType("step");
+        when(xiaomiHealthService.sync(anyLong(), eq("step"))).thenReturn(ok);
+
+        Result<Map<String, Object>> resp = controller.sync(params("memberId", 5L, "dataType", "step"), null);
+
+        assertEquals(200, resp.getCode());
+        Map<String, Object> data = resp.getData();
+        assertNotNull(data);
+        for (String key : SYNC_SINGLE_KEYS) {
+            assertTrue(data.containsKey(key), "sync 单类型响应应包含 " + key + "(§13.1)");
+        }
+        assertEquals("step", data.get("dataType"));
+        assertNotNull(data.get("result"));
+    }
+
+    @Test
+    @DisplayName("正常流-5:sync 全量响应透传 §13.1 契约字段")
+    void syncAllTypes_contractFieldsPassthrough() {
+        XiaomiSyncResult ok = new XiaomiSyncResult();
+        ok.setSuccess(true);
+        ok.setDataType("sleep");
+        when(xiaomiHealthService.syncAll(anyLong())).thenReturn(Collections.singletonList(ok));
+
+        Result<Map<String, Object>> resp = controller.sync(params("memberId", 5L), null);
+
+        assertEquals(200, resp.getCode());
+        Map<String, Object> data = resp.getData();
+        assertNotNull(data);
+        for (String key : SYNC_ALL_KEYS) {
+            assertTrue(data.containsKey(key), "sync 全量响应应包含 " + key + "(§13.1)");
+        }
+        assertNotNull(data.get("results"));
+    }
+
+    @Test
+    @DisplayName("正常流-6:revoke 响应透传 §13.1 契约字段")
+    void revoke_contractFieldPassthrough() {
+        when(xiaomiAuthService.revoke(anyLong())).thenReturn(true);
+
+        Result<Map<String, Object>> resp = controller.revoke(params("memberId", 5L), null);
+
+        assertEquals(200, resp.getCode());
+        Map<String, Object> data = resp.getData();
+        assertNotNull(data);
+        for (String key : REVOKE_KEYS) {
+            assertTrue(data.containsKey(key), "revoke 响应应包含 " + key + "(§13.1)");
+        }
+        assertEquals(true, data.get("revoked"));
+    }
+
+    @Test
+    @DisplayName("正常流-7:status 响应透传 §13.1 契约字段")
+    void status_contractFieldsPassthrough() {
+        JSONObject json = new JSONObject();
+        json.put("bound", true);
+        json.put("channel", "mock");
+        json.put("mock", true);
+        json.put("configured", false);
+        json.put("expiresAt", new Date());
+        json.put("scope", "steps,sleep,heart_rate,weight");
+        when(xiaomiAuthService.statusJson(anyLong())).thenReturn(json);
+
+        Result<Map<String, Object>> resp = controller.status(params("memberId", 5L), null);
+
+        assertEquals(200, resp.getCode());
+        Map<String, Object> data = resp.getData();
+        assertNotNull(data);
+        for (String key : STATUS_KEYS) {
+            assertTrue(data.containsKey(key), "status 响应应包含 " + key + "(§13.1)");
+        }
+        assertEquals(true, data.get("bound"));
+        assertEquals("mock", data.get("channel"));
+    }
+
+    // ==================== 边界流:缺失 code → 400 行为保持(GREEN,§13.4-4) ====================
+
+    @Test
+    @DisplayName("边界流-1:callback 缺失 code → 400(§13.4-4 行为保持)")
+    void callback_missingCode_returns400() {
+        Result<Map<String, Object>> resp = controller.callback(params("memberId", 5L), null);
+
+        assertEquals(400, resp.getCode(),
+                "缺失 code 应返回 400(§13.4-4:callback 对缺失 code 返回 400 行为保持)");
+        assertTrue(resp.getMessage().contains("code"));
+        verify(xiaomiAuthService, never()).exchangeCode(anyString(), anyLong());
+    }
+
+    // ==================== 正常流:后端小修 B1 - state 校验锚点缺失(RED) ====================
+
+    @Test
+    @DisplayName("正常流-B1-1:callback 链路应声明 state 校验锚点(防 CSRF,§13.3/13.4-4)")
+    void callback_chain_declaresStateValidationAnchor() {
+        Class<?> controller = loadClass(CONTROLLER_CLASS);
+        assertNotNull(controller, CONTROLLER_CLASS + " 不存在");
+
+        Class<?> authService = loadClass(AUTH_SERVICE_CLASS);
+        assertNotNull(authService, AUTH_SERVICE_CLASS + " 不存在");
+
+        boolean controllerHasStateAnchor = hasStringConstantContaining(controller, STATE_KEY)
+                || hasMethodNamedLike(controller, STATE_KEY);
+        boolean serviceHasStateAnchor = hasStringConstantContaining(authService, STATE_KEY)
+                || hasMethodNamedLike(authService, STATE_KEY);
+
+        assertTrue(controllerHasStateAnchor,
+                "[xiaomi.health.miniapp] §13.3/13.4-4:callback 链路需校验 state(防 CSRF)。"
+                        + "XiaomiHealthController 应声明 state 常量(如 PARAM_STATE)或含 state 的校验方法。"
+                        + "当前 src/main 无 state 锚点(callback 仅读 code/memberId),anti-CSRF 缺失。");
+
+        assertTrue(serviceHasStateAnchor,
+                "[xiaomi.health.miniapp] §13.3/13.4-4:XiaomiAuthService 应提供 state 校验入口(常量或 validateState 方法)。"
+                        + "当前 src/main 无 state 校验方法/常量,callback 链路无法完成 anti-CSRF 校验。");
+    }
+
+    // ==================== 边界流:契约一致 - mock 模式 state 字段缺失(RED) ====================
+
+    @Test
+    @DisplayName("边界流-契约一致-1:auth-url mock 模式响应应含 state 字段(§13.1/13.4-2)")
+    void authUrl_mockMode_returnsStateField() {
+        // 反射构造 service 并开启 mockEnabled(无 Spring 容器)
+        XiaomiAuthService service = new XiaomiAuthService();
+        try {
+            Field mockField = XiaomiAuthService.class.getDeclaredField("mockEnabled");
+            mockField.setAccessible(true);
+            mockField.setBoolean(service, true);
+        } catch (Exception e) {
+            fail("反射设置 mockEnabled 失败: " + e.getMessage());
+        }
+
+        Map<String, Object> built = service.buildAuthUrl(5L);
+
+        assertTrue(built.containsKey("state"),
+                "[xiaomi.health.miniapp] §13.1 契约要求 auth-url 响应含 state 字段,"
+                        + "§13.4-2 要求 api.js 5 方法字段与 13.1 逐一致。"
+                        + "当前 mockEnabled=true 时 buildAuthUrl 返回 map 无 \"state\" 键(仅 URL 内嵌),"
+                        + "与 13.1 契约不一致。GREEN 需在 mock 分支补 result.put(\"state\", state)。");
+    }
+
+    // ==================== 边界流:后端小修 B1 - redirect-uri 默认值(RED) ====================
+
+    @Test
+    @DisplayName("边界流-B1-2:redirect-uri 默认值应为 H5 中转页(§13.3)")
+    void redirectUri_default_isH5RelayPage() {
+        String yml = readResource("application.yml");
+        assertFalse(yml.isEmpty(), "application.yml 未在 classpath 找到");
+
+        // 定位 xiaomi 块后的 redirect-uri 行
+        int xiaomiIdx = yml.indexOf("xiaomi:");
+        if (xiaomiIdx < 0) {
+            fail("application.yml 缺少 xiaomi 配置节");
+        }
+        int redirectIdx = yml.indexOf("redirect-uri:", xiaomiIdx);
+        if (redirectIdx < 0) {
+            fail("application.yml xiaomi 节缺少 redirect-uri");
+        }
+        // 提取该行
+        int lineEnd = yml.indexOf('\n', redirectIdx);
+        String line = yml.substring(redirectIdx, lineEnd > 0 ? lineEnd : yml.length()).trim();
+        String defaultVal = extractDefault(line);
+
+        assertFalse(defaultVal.contains(OLD_REDIRECT_PATH),
+                "[xiaomi.health.miniapp] §13.3:redirect-uri 默认值不应为旧回调路径 " + OLD_REDIRECT_PATH
+                        + "(GET 回调不可用),当前默认值:" + defaultVal);
+
+        assertTrue(defaultVal.contains(RELAY_PAGE_MARKER),
+                "[xiaomi.health.miniapp] §13.3:redirect-uri 默认值应为 H5 中转页(含 " + RELAY_PAGE_MARKER + " 标识),"
+                        + "当前默认值:" + defaultVal + "。GREEN 需改 application.yml 默认值为 xiaomi-cb.html 所在 H5 地址。");
+    }
+
+    // ==================== 权限流(不适用) ====================
+
+    @Test
+    @DisplayName("权限流:本能力为小程序端 OAuth 授权 + 数据同步,权限流不适用")
+    void permissionFlow_notApplicable() {
+        // 说明性用例:JWT 拦截 /api/** 已在 JwtInterceptor,本能力不新增用户权限维度
+        assertTrue(true, "权限流不适用:xiaomi.health.miniapp 为小程序端授权/同步链路,登录态由后端统一 JWT 鉴权。");
+    }
+
+    // ------------------------------------------------------------------
+    // 反射/IO 辅助
+    // ------------------------------------------------------------------
+
+    private Class<?> loadClass(String name) {
+        try {
+            return Class.forName(name, false, Thread.currentThread().getContextClassLoader());
+        } catch (ClassNotFoundException e) {
+            return null;
+        }
+    }
+
+    /** 是否存在静态 String 常量值包含 target */
+    private boolean hasStringConstantContaining(Class<?> clazz, String target) {
+        if (clazz == null) return false;
+        for (Field f : clazz.getDeclaredFields()) {
+            if (f.getType() != String.class) continue;
+            if (!Modifier.isStatic(f.getModifiers()) || !Modifier.isFinal(f.getModifiers())) continue;
+            try {
+                f.setAccessible(true);
+                Object v = f.get(null);
+                if (v instanceof String && ((String) v).contains(target)) return true;
+            } catch (Exception ignored) {}
+        }
+        return false;
+    }
+
+    /** 是否存在方法名(忽略大小写)包含片段 */
+    private boolean hasMethodNamedLike(Class<?> clazz, String fragment) {
+        if (clazz == null) return false;
+        String needle = fragment.toLowerCase();
+        for (Method m : clazz.getDeclaredMethods()) {
+            if (m.getName().toLowerCase().contains(needle)) return true;
+        }
+        return false;
+    }
+
+    private Map<String, Object> params(Object... kv) {
+        Map<String, Object> m = new LinkedHashMap<>();
+        for (int i = 0; i < kv.length; i += 2) {
+            m.put(String.valueOf(kv[i]), kv[i + 1]);
+        }
+        return m;
+    }
+
+    private String readResource(String name) {
+        try (InputStream is = getClass().getClassLoader().getResourceAsStream(name)) {
+            if (is == null) return "";
+            Scanner s = new Scanner(is, StandardCharsets.UTF_8.name());
+            s.useDelimiter("\\A");
+            return s.hasNext() ? s.next() : "";
+        } catch (Exception e) {
+            return "";
+        }
+    }
+
+    private String extractDefault(String line) {
+        // line 形如: redirect-uri: ${XIAOMI_REDIRECT_URI:https://...}
+        int si = line.indexOf("${");
+        if (si < 0) {
+            int col = line.indexOf(':');
+            return col >= 0 ? line.substring(col + 1).trim() : "";
+        }
+        int colon = line.indexOf(':', si);
+        int close = line.indexOf('}', colon);
+        if (colon < 0 || close < 0) return "";
+        return line.substring(colon + 1, close).trim();
+    }
+}