From e0e1edcfd111e2d0730f7ce2bedcbd37a0fee1cd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E9=BB=84=E8=87=AA=E8=BE=BE?= <980324341@qq.com> Date: Mon, 5 Oct 2026 18:30:23 +0800 Subject: [PATCH] =?UTF-8?q?test(=E5=85=AC=E5=8F=B8tab):=20G2=20=E8=A1=A5?= =?UTF-8?q?=E6=96=AD=E8=A8=80=20D=E2=80=94=E2=80=94=E5=85=AC=E5=8F=B8?= =?UTF-8?q?=E5=8F=82=E6=95=B0=E5=BF=85=E9=A1=BB=E7=9C=9F=E8=BF=9B=20readSc?= =?UTF-8?q?ope/resolveScope=20=E7=9A=84=E5=AE=9E=E5=8F=82=E5=88=97?= =?UTF-8?q?=E8=A1=A8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A/B/C 三条判据都只看"收了参数、调了出口、结果交出去了",对 readScope(operator, null) 这一形全部放行:参数照样绑、出口照样调、返回值照样用,tab 却一动不动、接口还是 200。 D 咬的是入口那一侧——用 @RequestParam 绑到的那个变量名必须作为整词出现在出口调用的 实参列表里(射程与 A/B/C 同源:同一个 takesCompanyParam 谓词、同一份 READ_SCOPE_ALLOWLIST, 一条豁免同时免四条,不另起第二张表)。四条探针接进同一支跑探针的 @Test,null 形必红、 经 helper 转手的正形必绿,且已实测 A/B/C 对 null 探针三条前提全绿(D 才有鉴别力)。 --- ...ompanyIdParamGoesThroughReadScopeTest.java | 278 +++++++++++++++++- 1 file changed, 277 insertions(+), 1 deletion(-) diff --git a/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyIdParamGoesThroughReadScopeTest.java b/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyIdParamGoesThroughReadScopeTest.java index 0f12231e9..4413ab501 100644 --- a/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyIdParamGoesThroughReadScopeTest.java +++ b/backend-java/src/test/java/com/nanri/aiimage/common/service/CompanyIdParamGoesThroughReadScopeTest.java @@ -95,6 +95,25 @@ import org.junit.jupiter.api.Test; * ② 该变量必须出现在 handler 体内另一条方法调用的实参列表里(扣掉它自己那条赋值语句, * 单层括号够用,今天两页都是这一形)。只要求"在别处被引用一次"不够: * {@code if (scoped != null) throw …} 是装饰,不算把范围交给谁 ⇒ 控制语句关键字不认。 + *
  • 调了出口不等于把公司参数交给了出口(本轮新增的断言 D)。现网最难查的一刀是 + * {@code dataReadScope.readScope(operator, null)}:参数照样收下(B 绿)、{@code readScope(} 照样写在 + * handler 体内(A 绿)、算出来的范围照样接住并喂给 service(C 绿),唯独 tab 传下来的那个值 + * 没进出口——症状是"接口 200、页面一切正常、切 tab 数字永远不动",G1 只看前端文本同样不红。 + * D 因此先按 {@link Block#boundCompanyParam()} 从声明窗口里取出被绑定到 + * {@code company_id} 的变量名(不硬编码 {@code companyId}:这一支改叫 {@code orgId} 就用 + * {@code orgId} 判),再要求它作为整词实参出现在 {@code readScope}/{@code resolveScope} 的参数表里 + * (单层括号,复用 {@link #CALL_ARGUMENTS};私有收口方法 {@code resolveScope(request, companyId)} + * 那一形算,Task 11 模板鼓励的正是它)。只写在 {@code if (companyId != null)} 里、或只出现在 + * {@code @Operation} 文案里,都不算消费——沿用 C 的 {@link #NOT_VALUE_CONSUMERS} 那把尺子,不放宽。 + * 射程与 A/B/C 同源:同一个 {@code takesCompanyParam()} 谓词、同一份 + * {@link #READ_SCOPE_ALLOWLIST}(一条豁免同时免 A/B/C/D,不许另起第二张表),并且只咬 + * {@code viaRequestParam()} 那一族(F-C 的同一把尺子:{@code getParameter("company_id")} 给不出 + * 绑定变量名,D 对它无从判定)。取不到绑定名 = 形状不认识 ⇒ 判红并报形状,不许静默放过。 + * D 的代价与射程一并交代(本轮报告有逐条清单):{@link #CALL_ARGUMENTS} 只吃单层括号,于是 + * {@code readScope(operator, normalize(companyId))} 这种嵌套写法会判红(误伤合规代码,改写法或补宽 + * D 的取法都算核对过);非 {@code Long} 型公司参数取不到绑定名,同样判红;而"handler 之外的私有 + * 收口方法里把公司参数硬写成 {@code null}"这一族 D 看不见——块边界止于该 handler 自己的闭括号 + * (第 7 条),{@code AdminImageVideoTaskController.scopeOf} 正是它,那一处是故意传 null 的。
  • * * *

    取样键:可执行行里出现 {@code company_id} 或 {@code companyId}(裸 token 即入样本,交给逐 handler @@ -170,6 +189,24 @@ class CompanyIdParamGoesThroughReadScopeTest { private static final Set NOT_VALUE_CONSUMERS = Set.of( "if", "for", "while", "switch", "do", "catch", "synchronized", "return", "throw", "else", "try"); + /** + * 断言 D 认的两个被调名:{@code readScope} 是唯一出口本身,{@code resolveScope} 是 Task 11 模板 + * 鼓励的"controller 里的私有收口方法"那一形(它内部再去 readScope)。除此之外的调用都不算 + * "把公司参数交给了出口"——尤其 {@code readScope(operator, null)} 里那个 {@code null}。 + */ + private static final String RESOLVE_SCOPE_CALL = "resolveScope("; + private static final Set SCOPE_CALLEES = Set.of("readScope", "resolveScope"); + + /** + * 断言 D 的取绑定名(两把锚一起用):先在声明窗口里找 {@code name = "company_id"} + * (容 {@code name="company_id"} 这类空格写法,且窗口已 join ⇒ 折行签名也认), + * 再取它之后第一个 {@code Long 变量名}。取"之后第一个"而不是"最后一个": + * {@code ShopManageController.page} 的参数表里 {@code Long page}/{@code Long pageSize}/{@code Long groupId} + * 都排在公司参数之前,抓最后一个或整窗抓都会抓错人。 + */ + private static final Pattern EXPLICIT_COMPANY_NAME = Pattern.compile("name\\s*=\\s*\"company_id\""); + private static final Pattern COMPANY_PARAM_DECL = Pattern.compile("Long\\s+([A-Za-z_$][\\w$]*)"); + /** * 参数绑定注解(F-A):一行里出现它们,这一行就是真参数声明,无论同行是否还写着 * {@code description =}——本仓 93 行 {@code @Parameter(description = "…") @RequestParam(…)} 挤同一行的 @@ -256,8 +293,68 @@ class CompanyIdParamGoesThroughReadScopeTest { } """; + /** + * 断言 D 的负探针(D 的存在理由):公司参数收了、{@code readScope(} 也写在 handler 体内、 + * 结果也接住并喂给了 service——唯独 tab 传下来的那个值被写成了 {@code null}。 + *

    A/B/C 三条判据对这段源码都判通过(用例里带了这三条反面证据,判不过就说明探针没有区分度、 + * D 只是重复劳动),G1 只看前端文本同样不红;现网症状"接口 200、页面正常、切 tab 数字永远不动" + * 就是这一形。只有 D 红。

    + */ + private static final String SCOPE_PASSED_NULL_PROBE = """ + @GetMapping("/probe") + public String passedNull(@RequestParam(name = "company_id", required = false) Long companyId) { + List ids = dataReadScope.readScope(operator, null).userIdsOr(null); + shopService.page(page, ids); + return "ok"; + } + """; + + /** + * 断言 D 的正探针:{@code companyId} 交给同文件的私有收口方法({@code resolveScope(request, companyId)}, + * Task 11 模板那一形,内部再去 readScope)⇒ D 不许红。 + */ + private static final String SCOPE_PASSED_THROUGH_HELPER_PROBE = """ + @GetMapping("/probe") + public String passedHelper(@RequestParam(name = "company_id", required = false) Long companyId, + HttpServletRequest request) { + ScopeContext scope = resolveScope(request, companyId); + return String.valueOf(taskCenterQueryService.overview(scope)); + } + """; + + /** + * 断言 D 的负探针 2(任务书 D.3 最后那一记"别放宽"的独立证据):{@code companyId} 只被 {@code if} + * 读了一次(控制语句不算消费,与 C 共用 {@link #NOT_VALUE_CONSUMERS} 那把尺子),进出口的是 {@code null} + * ⇒ D 必须红。断言 A/B/C 对它同样全绿:{@code readScope(} 在、{@code name = "company_id"} 在、 + * 结果接进 {@code scoped} 又喂给了 {@code shopService.page(…, scoped)}。 + */ + private static final String SCOPE_ONLY_IF_DECOR_PROBE = """ + @GetMapping("/probe") + public String onlyIf(@RequestParam(name = "company_id", required = false) Long companyId) { + if (companyId != null) { + log.info("tab 切了"); + } + List scoped = dataReadScope.readScope(operator, null).userIdsOr(null); + return String.valueOf(shopService.page(page, scoped)); + } + """; + + /** + * 断言 D 的"绑定名不许硬编码"探针:这一支的公司参数声明叫 {@code orgId}(有的页会把它叫别的名字), + * 并且真把 {@code orgId} 交给了出口 ⇒ D 必须用它自己取到的名字去判,判绿。 + * 如果 D 里写死了 {@code companyId},这一支会假红——这条就是那件事的反面证据。 + */ + private static final String SCOPE_ALTERNATE_NAME_PROBE = """ + @GetMapping("/probe") + public String otherName(@RequestParam(name = "company_id", required = false) Long orgId) { + List scoped = dataReadScope.readScope(operator, orgId).userIdsOr(null); + return String.valueOf(shopService.page(page, scoped)); + } + """; + @Test - @DisplayName("每个收公司 id 参数的 handler 都走唯一出口,并且显式写了 name = \"company_id\"") + @DisplayName("每个收公司 id 参数的 handler 都走唯一出口、显式写了 name = \"company_id\"," + + "而且 tab 传下来的那个值真被交给了出口(A/B/C/D)") void everyCompanyIdHandlerGoesThroughReadScope() throws IOException { assertThat(READ_SCOPE_ALLOWLIST) .as("白名单只允许 AdminUserController 一条:多一条 = 有人新开了一个不走唯一出口的 if") @@ -309,10 +406,43 @@ class CompanyIdParamGoesThroughReadScopeTest { .as("断言 C 自检(第二形):ReadScope s = dataReadScope.readScope(…) 且 s 进了 service.page(…) 的实参 ⇒ 同样要认") .isNull(); + // 断言 D 的判据自检(两个方向都要,全局约束 15)。负探针要先证明"A/B/C 三条对它都判通过"—— + // 这三条前提不成立就说明这段源码本来已经有人看守,D 没有区分度、只是重复劳动。 + String nullProbeText = String.join("\n", textsOf(sourceLines(SCOPE_PASSED_NULL_PROBE))); + assertThat(nullProbeText) + .as("断言 D 负样本的前提(断言 A):readScope( 确实写在 handler 体内 ⇒ A 判它绿") + .contains(READ_SCOPE_CALL); + assertThat(nullProbeText) + .as("断言 D 负样本的前提(断言 B):name = \"company_id\" 字面量也在 ⇒ B 判它绿") + .contains(EXPLICIT_PARAM_NAME); + assertThat(scopeProbeReason(SCOPE_PASSED_NULL_PROBE, "SCOPE_PASSED_NULL_PROBE")) + .as("断言 D 负样本的前提(断言 C):范围照样接住并喂给了 service ⇒ C 也判它绿;" + + "三条前提同时成立才说明『参数被传成 null』这一刀今天没人杀") + .isNull(); + assertThat(companyIdArgProbeReason(SCOPE_PASSED_NULL_PROBE, "SCOPE_PASSED_NULL_PROBE", CAMEL_PARAM)) + .as("断言 D 自检(负样本):readScope(operator, null) —— 公司参数没进出口 ⇒ 必须判红") + .isNotNull() + .contains("没进任何 readScope/resolveScope 的实参列表"); + assertThat(companyIdArgProbeReason(SCOPE_ONLY_IF_DECOR_PROBE, "SCOPE_ONLY_IF_DECOR_PROBE", CAMEL_PARAM)) + .as("断言 D 自检(负样本 2):companyId 只被 if 读了一次、进出口的是 null ⇒ 同样要红" + + "(控制语句不算消费,与 C 同一把尺子)") + .isNotNull() + .contains("没进任何 readScope/resolveScope 的实参列表"); + assertThat(companyIdArgProbeReason(SCOPE_PASSED_THROUGH_HELPER_PROBE, "SCOPE_PASSED_THROUGH_HELPER_PROBE", CAMEL_PARAM)) + .as("断言 D 自检(正样本):companyId 交给同文件私有 resolveScope(request, companyId) ⇒ 判据不许恒红") + .isNull(); + assertThat(companyIdArgProbeReason(SCOPE_ALTERNATE_NAME_PROBE, "SCOPE_ALTERNATE_NAME_PROBE", "orgId")) + .as("断言 D 自检(改名那一族):参数声明叫 orgId、交出去的也是 orgId ⇒ 不许红" + + "(这条同时钉住\"D 不许硬编码 companyId\":写死了它就会在这一支假红)") + .isNull(); + // 断言 C 的分母由本轮实扫得出(不写死数字):扫进射程的 handler 键、走完两步的正样本支数、红因先攒后判。 List scopeCaughtSample = new ArrayList<>(); List scopeDiscarded = new ArrayList<>(); int scopeCaughtHandlers = 0; + // 断言 D 的分母同一把尺子(同一批 handler、同一份豁免键):被 D 评过的 handler 键 + 红因先攒后判。 + List companyIdArgSample = new ArrayList<>(); + List companyIdArgMissing = new ArrayList<>(); List sampled = sampledControllers(); assertThat(sampled) @@ -361,6 +491,20 @@ class CompanyIdParamGoesThroughReadScopeTest { scopeDiscarded.add(where + dropped); } } + // 断言 D(本轮新增):范围"算过"且"交出去了"还不够——C 咬的是 readScope( 的返回值, + // D 咬的是它的入参:tab 传下来的那个变量名必须真出现在 readScope/resolveScope 的 + // 实参列表里。readScope(operator, null) 三条判据全绿而 tab 恒不动,就是这一记。 + // 射程与 A/B/C 同源:同一个 takesCompanyParam() 谓词、同一份 READ_SCOPE_ALLOWLIST + // (一条豁免同时免 A/B/C/D,不另起第二张表);只咬 viaRequestParam() 那一族(F-C 同一把 + // 尺子:getParameter("company_id") 那一族给不出绑定变量名,D 对它无从判定,不硬判)。 + if (takesCompanyParam && handler.viaRequestParam() && handler.hasScopeCall() + && !READ_SCOPE_ALLOWLIST.contains(exemptionKey(rel, handler))) { + companyIdArgSample.add(exemptionKey(rel, handler)); + String argMissing = handler.companyIdArgFailure(); + if (argMissing != null) { + companyIdArgMissing.add(where + argMissing); + } + } } // 残块(package/import/类级注解/字段,以及 handler 收口之后、下一支 handler 之前的尾随方法) @@ -391,6 +535,19 @@ class CompanyIdParamGoesThroughReadScopeTest { assertThat(scopeDiscarded) .as("范围算了但没接住(断言 C):readScope( 的结果要么没赋给变量,要么赋了却没交给任何方法调用") .isEmpty(); + + // 断言 D 的取样自检与分母(与 C 同一族纪律):空样本 = D 空转,射程不含已接线的页 = 静默脱离。 + assertThat(companyIdArgSample) + .as("断言 D 取样集非空自检:一支『用 @RequestParam 收了公司 id 参数、体内又调了 " + + "readScope/resolveScope』的 handler 都没扫到 ⇒ D 一行都没评") + .isNotEmpty(); + assertThat(companyIdArgSample) + .as("断言 D 的射程必须覆盖已接线的那两页(改名/换 mapping 会让它静默脱离射程,分母不能自造)") + .contains(SCOPE_CAUGHT_HISTORY_KEY, SCOPE_CAUGHT_VIDEO_KEY); + assertThat(companyIdArgMissing) + .as("公司参数没被交给出口(断言 D):readScope/resolveScope 的实参列表里没有出现被绑定到 " + + "company_id 的那个变量名 —— 参数收下、出口也调了,tab 却是死的") + .isEmpty(); } @Test @@ -436,6 +593,34 @@ class CompanyIdParamGoesThroughReadScopeTest { return handler.scopeCatchFailure(); } + /** + * 断言 D 的探针驱动器(形状同 {@link #scopeProbeReason},不新开风格):先确认这段样本真被切成 + * "1 支用 {@code @RequestParam} 收公司 id 参数、体内调了 readScope/resolveScope"的 handler, + * 再钉住"取到的绑定名 == 探针里写的那个参数名"——取不到或取错人 = D 没在读声明窗口而是在硬编码 + * {@code companyId},那 D 自己就是坏的,探针必须红给编写者看;最后跑 + * {@link Block#companyIdArgFailure()} 取红因。 + */ + private static String companyIdArgProbeReason(String probeSource, String probeName, String expectedBinding) { + List blocks = splitBlocks(sourceLines(probeSource)).handlers(); + assertThat(blocks) + .as(probeName + " 应当恰好切出 1 支 handler;切不出来则断言 D 的自检无从判定") + .hasSize(1); + Block handler = blocks.get(0); + assertThat(handler.takesCompanyParam()) + .as(probeName + " 的 handler 没被认成收公司 id 参数,断言 D 根本不会触发 ⇒ 探针失效") + .isTrue(); + assertThat(handler.viaRequestParam()) + .as(probeName + " 的公司参数不是 @RequestParam 绑定形状,断言 D 不咬它 ⇒ 探针失效") + .isTrue(); + assertThat(handler.boundCompanyParam()) + .as(probeName + " 取到的绑定名与探针声明的参数名不一致 ⇒ D 没在读声明窗口(硬编码 companyId 的形状)") + .isEqualTo(expectedBinding); + assertThat(handler.hasScopeCall()) + .as(probeName + " 的 handler 体内没有 readScope( 或 resolveScope( ,断言 D 扫不到它 ⇒ 探针失效") + .isTrue(); + return handler.companyIdArgFailure(); + } + /** 取样=可执行行里出现公司 token(下划线或驼峰),逐 handler 的窗口谓词再判定是否真收参数。 */ private static List sampledControllers() throws IOException { if (!Files.isDirectory(MAIN_ROOT)) fail("找不到 " + MAIN_ROOT + " —— 用例依赖以 backend-java 为工作目录"); @@ -769,6 +954,97 @@ class CompanyIdParamGoesThroughReadScopeTest { } return false; } + + /** + * 断言 D 的"这支到底调没调出口"门槛:连 {@code readScope(}/{@code resolveScope(} 都没写的 handler, + * 红它的是断言 A,D 不叠一条重复的红(免得同一支同时冒出两条口径不同的消息)。 + */ + boolean hasScopeCall() { + String src = text(); + return src.contains(READ_SCOPE_CALL) || src.contains(RESOLVE_SCOPE_CALL); + } + + /** + * 断言 D 的取绑定名:在声明窗口(mapping 注解行 → 方法体开行,join 后判 ⇒ 折行签名与 + * {@code @Parameter(…) @RequestParam(…)} 挤同一行的主流写法都认)里找 {@code name = "company_id"}, + * 取它之后第一个 {@code Long 变量名}("之后"必须留、"第一个"也必须留: + * {@code ShopManageController.page} 的 {@code Long page}/{@code Long pageSize}/{@code Long groupId} + * 全排在公司参数前面,整窗抓最后一个就抓错人了)。 + *

    窗口里没有显式 {@code name=} 的那一支(驼峰静默失效,断言 B 已经为它判红)退回"窗口里第一条 + * 带公司 token 的非文档行"取同一个名字。取的是源码里那个名字,不是 {@link #CAMEL_PARAM} 常量: + * 有的页把它叫 {@code orgId},写死就会在合规页上假红(改名为 orgId 的探针就是这条的反面证据)。 + *

    返回 {@code null} = 公司参数不是 {@code … Long x} 那一形,由 {@link #companyIdArgFailure()} 判红 + * 并报形状,不许"当作这支没收公司参数"静默放过;窗口本身取不到的那一支由结构守卫负责,D 不重复报。

    + */ + String boundCompanyParam() { + List window = declarationWindow(); + if (window == null) { + return null; + } + String joined = String.join("\n", window); + Matcher anchor = EXPLICIT_COMPANY_NAME.matcher(joined); + if (anchor.find()) { + return firstLongDeclaration(joined.substring(anchor.end())); + } + for (String line : window) { + if (hasCompanyToken(line) && !isDocLine(line)) { + String name = firstLongDeclaration(line); + if (name != null) { + return name; + } + } + } + return null; + } + + /** {@code Long 变量名} 的第一个命中;窗口里根本没有 {@code Long} 型参数就取不到(返回 null)。 */ + private static String firstLongDeclaration(String declarationText) { + Matcher declared = COMPANY_PARAM_DECL.matcher(declarationText); + return declared.find() ? declared.group(1) : null; + } + + /** + * 断言 D:被绑定到 {@code company_id} 的那个变量名,必须作为整词实参出现在这一支 handler + * 体内某一次 {@code readScope}/{@code resolveScope} 调用的参数表里(单层括号,复用 + * {@link #CALL_ARGUMENTS} 的形状,与 A/B/C 同一个 handler 窗口)。 + *
      + *
    • {@code dataReadScope.readScope(operator, companyId)} ⇒ 绿;
    • + *
    • {@code resolveScope(request, companyId)}(私有收口方法内部再去 readScope)⇒ 绿;
    • + *
    • {@code dataReadScope.readScope(operator, null)} ⇒ 红;
    • + *
    • {@code readScope(operator, operator.getCompanyId())} ⇒ 红:源里那个名字是 + * {@code CompanyId}(大写 C,整词判据大小写敏感,咬不住它);而 {@link #CALL_ARGUMENTS} + * 只吃单层括号,看不穿 {@code readScope(operator, normalize(companyId))} 这种嵌套写法 —— + * 两种都落在"没进参数表"那一侧(后者是会误伤合规写法的已知形状,见类注释第 11 条与本轮报告);
    • + *
    • 只在 {@code if (companyId != null)} 里读一次、或只在 {@code @Operation} 文案里提一句 + * ⇒ 红:控制语句关键字沿用 {@link #NOT_VALUE_CONSUMERS} 那把尺子(与 C 同源,不放宽), + * 而注释与文档行根本进不到 {@link #text()} 里。
    • + *
    + *

    返回 {@code null} = 公司参数确实交给了出口;否则返回红因片段,由调用方拼上 handler 名。 + */ + String companyIdArgFailure() { + String bound = boundCompanyParam(); + if (bound == null) { + return " 认不出被绑定到 company_id 的变量名(断言 D 只认 @RequestParam(name = \"company_id\") … " + + "Long 变量名 那一形),这支的公司参数是怎么进出口的无从判定 —— 必须人工核对," + + "不许当作\"这支没收公司参数\"静默放过"; + } + Matcher call = CALL_ARGUMENTS.matcher(text()); + Pattern use = Pattern.compile("(?