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("(?