From e43203c8789a6f5260b793aead439841d58318b4 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 05:28:13 +0800
Subject: [PATCH] =?UTF-8?q?test(=E5=85=AC=E5=8F=B8=E8=8C=83=E5=9B=B4):=20G?=
=?UTF-8?q?2=20=E6=96=AD=E8=A8=80=20B=20=E8=B5=B0=E5=90=8C=E6=BA=90?=
=?UTF-8?q?=E5=8F=82=E6=95=B0=E8=B0=93=E8=AF=8D,=E5=85=AC=E5=8F=B8?=
=?UTF-8?q?=E5=8F=82=E6=95=B0=E5=88=A4=E5=AE=9A=E6=94=B9=E5=A3=B0=E6=98=8E?=
=?UTF-8?q?=E7=AA=97=E5=8F=A3,=E8=B1=81=E5=85=8D=E9=99=8D=E5=88=B0=20handl?=
=?UTF-8?q?er=20=E7=BA=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Fix round 2 补 round 1 自留的三条缺口(生产代码与其它测试一字未改,只动这一支):
- N1 断言 B 触发键从下划线字面量换成与 A 同源的 handler.takesCompanyParam(),
"驼峰参数名+真调 readScope+全文不出现 company_id" 那记静默绿现会被 B 咬红。
- N2 公司参数判定从"同行"改成"声明窗口"(mapping 行到第一个以 { 结尾的行),
覆盖折行签名;并把 request.getParameter("company*") 同族纳入触发;
窗口取不到判红并报块名,不再"窗口取不到就当没公司参数"。
- N3 豁免键从整文件降到 handler 级(路径#@GetMapping(...)),hasSize(1) 保留;
liveness 语义跟改准,既咬僵尸条目也咬被豁免文件里没点名的第二记公司 id handler。
---
...ompanyIdParamGoesThroughReadScopeTest.java | 183 ++++++++++++++----
1 file changed, 149 insertions(+), 34 deletions(-)
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 3b7f5b613..ca5dc016a 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
@@ -8,6 +8,7 @@ import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.Arrays;
+import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.regex.Pattern;
@@ -25,7 +26,7 @@ import org.junit.jupiter.api.Test;
* controller 调,再把算好的成员集当参数传进去(docs/plans/19-company-tab.md「Task 11 已确认现状」第 2 条)。
* 因此"handler 体内出现 readScope("就是这一页接了唯一出口的证据。
*
- * 三条口径都是评审实测出的洞,逐条钉住:
+ * 口径都是评审实测出的洞,逐条钉住:
*
* - 断言只打在可执行行上。原先全文比对时,把 {@code readScope(} 与 {@code name = "company_id"}
* 只写进 javadoc、参数实际用驼峰 {@code Long companyId} 的 controller 照样绿(评审 I-4a:
@@ -37,23 +38,39 @@ import org.junit.jupiter.api.Test;
* 也要补(评审 I-4b:文件级比对下 list() 没收、detail() 收了 ⇒ 整文件仍绿)。
* 所以按 mapping 注解把文件切成 handler 块,逐块跑两条断言;切不进 handler 的残块
* (package/import/类级注解/字段)由一条显式断言看守,不许静默跳过。
- * - 白名单键是相对 src/main/java 的路径,不再是裸文件名。按裸文件名时任意包下的同名文件
- * 自动豁免(评审 I-5:{@code modules/tmpmutation/AdminUserController.java} 收 company_id、
- * 不走出口 ⇒ 绿)。另加 liveness:白名单每一项必须仍在取样集里,否则就是僵尸条目。
+ * - 白名单键是 handler 级(相对 {@code src/main/java} 的路径 + 该 handler 的 mapping 注解文本,
+ * 形如 {@code .../AdminUserController.java#@GetMapping("/users")})。round 1 用文件级键,往被豁免
+ * 文件里新加的任何端点会被一并免掉;round 1 的裸文件名版更是让任意包下同名文件自动豁免(评审 I-5)。
+ * 降级到 handler 级后,{@code hasSize(1)} 钉条目数、liveness 钉"每一项仍对应一个真在收公司 id 的
+ * handler",并额外咬住"被豁免文件里冒出第二个没点名的公司 id handler"。
+ * - 断言 A 与 B 用同一个"该 handler 是否收公司 id 参数"谓词({@link Block#takesCompanyParam()})。
+ * round 1 的 B 用下划线字面量 {@code company_id} 当触发键、A 用参数形状键,两者不同源 ⇒
+ * "驼峰参数名 + 真调 readScope + 全文不出现下划线"这种形状 A 绿、B 根本不触发(评审 N1:
+ * 正是"接口 200、前端发 company_id=、参数恒 null、tab 切了纹丝不动"那一记)。统一谓词后它必红。
+ * - "公司参数"判定认声明窗口,不认同行。round 1 要求公司 token 与 {@code @RequestParam}
+ * 落在同一物理行,本仓签名大量折行({@code AdminUserController:36-43} 一次摊 7 个参数),
+ * 折行写法就被静默跳过(评审 N2)。现从该 handler 的 mapping 注解行起、到第一个以
{
+ * 结尾的行为止取"声明窗口",窗口内同时出现 {@code @RequestParam} 与公司 token(排除
+ * {@code @Operation}/{@code description=} 这类文档串)即算"收公司 id 参数";另把
+ * {@code request.getParameter("company_id"/"companyId")} 这一族也纳入触发。窗口取不到(整块没有
+ * 以 { 结尾的行)判红并报块名,不许"窗口取不到就当没有公司参数"。
*
*
- * 取样键(第 4 条修的是 Important 5):可执行行里出现 {@code company_id},或同一行同时出现
- * {@code @RequestParam} 与驼峰 {@code companyId}。只按下划线字面量取样时,一支纯驼峰的端点根本进不了
- * 样本,整条护栏被绕过。今天加了驼峰形状后新样本为 0 支(只有 {@code AdminUserController:43} 命中,
- * 已在白名单),零假阳性,白名单不必重写。
+ * 取样键:可执行行里出现 {@code company_id} 或 {@code companyId}(裸 token 即入样本,交给逐 handler
+ * 的窗口谓词判定是否真收参数)。只按 {@code @RequestParam}+驼峰同行取样时,折行签名的文件根本进不了样本、
+ * 连窗口判定都不会跑(N2 的静默跳过正是这么发生的)。真实树今天含这两个 token 的 controller 恰有 3 支
+ * ({@code AdminUserController}/{@code AdminConsoleController}/{@code ZiniaoAuthController}),后两支的公司
+ * token 只在 {@code @Operation}/{@code item.put} 里、不在 {@code @RequestParam} 声明窗口上 ⇒ 零假阳性,
+ * 白名单不必重写。
*/
class CompanyIdParamGoesThroughReadScopeTest {
private static final Path MAIN_ROOT = Path.of("src/main/java");
/**
- * 点名白名单(相对 {@code src/main/java} 的路径、统一正斜杠,精确匹配,不许通配/前缀/裸文件名;
- * 今天唯一一项是 {@code com/nanri/aiimage/modules/admin/controller/AdminUserController.java})。
+ * 点名白名单(handler 级键:相对 {@code src/main/java} 的路径 + {@code #} + 该 handler 的
+ * mapping 注解文本,统一正斜杠,精确匹配,不许通配/前缀/裸文件名/整文件)。今天唯一一项是
+ * {@code com/nanri/aiimage/modules/admin/controller/AdminUserController.java#@GetMapping("/users")}。
*
* 只放一条:{@code AdminUserController} 的 {@code GET /api/admin/users?company_id=} 是先于本计划
* 存在、已在生产的那"第二个 if"——用户管理页不在本计划 8 个 tab 页里
@@ -62,18 +79,21 @@ class CompanyIdParamGoesThroughReadScopeTest {
* 正是全局约束 2 点名的参考形状。本批次不迁它:迁了等于把 140 值的 {@code id IN(...)} 换回
* {@code company_id =} 直查,性能方向是负的;已另记为批次 1 之后独立一笔。
*
- * 豁免语义(评审 Important 4 定稿):只豁免该文件各 handler 的 {@code readScope(} 断言,
- * 不豁免取样(剔掉白名单再自检非空会当场红,全局约束 15 要的就是这条),也不豁免
- * {@code name = "company_id"}——驼峰参数名静默失效那一类错不能被白名单盖住。
+ * 豁免语义:键精确到一个 handler,只豁免该 handler 的 {@code readScope(} 断言(断言 A),
+ * 不豁免取样(剔掉白名单再自检非空会当场红,全局约束 15 要的就是这条),不豁免 {@code name =
+ * "company_id"}(断言 B,驼峰参数名静默失效那一类错不能被白名单盖住),也不豁免"该文件的其它
+ * handler"——往这一条里塞第二个端点会同时被 A 和 liveness 咬住。
*/
private static final Set READ_SCOPE_ALLOWLIST =
- Set.of("com/nanri/aiimage/modules/admin/controller/AdminUserController.java");
+ Set.of("com/nanri/aiimage/modules/admin/controller/AdminUserController.java#@GetMapping(\"/users\")");
private static final String READ_SCOPE_CALL = "readScope(";
private static final String EXPLICIT_PARAM_NAME = "name = \"company_id\"";
private static final String SNAKE_PARAM = "company_id";
private static final String CAMEL_PARAM = "companyId";
private static final String REQUEST_PARAM = "@RequestParam";
+ private static final String GET_PARAMETER = "getParameter(";
+ private static final String WINDOW_OPEN = "{";
/** handler 的边界:这些注解组后面跟方法签名的是端点,跟类型声明的是类级。 */
private static final List MAPPING_ANNOTATIONS = List.of(
@@ -123,16 +143,23 @@ class CompanyIdParamGoesThroughReadScopeTest {
Blocks blocks = splitBlocks(lines);
for (Block handler : blocks.handlers()) {
String where = rel + " 的 handler " + handler.header();
- // 断言 A:收了公司 id 参数的 handler 必须在该 handler 体内走唯一出口。
- if (handler.takesCompanyParam() && !READ_SCOPE_ALLOWLIST.contains(rel)) {
+ // 声明窗口取不到 = 切块形状失效,绝不能"当作没公司参数"静默放过,必须红并报块名。
+ if (handler.windowUndeterminable()) {
+ fail(where + " 里找不到以 " + WINDOW_OPEN + " 结尾的行,无法确定声明窗口 —— "
+ + "切块形状失效(折行签名/单行体等),必须人工核对,不许当作\"该 handler 没收公司参数\"静默跳过");
+ }
+ // A 与 B 共用同一个参数形状谓词(N1:触发键必须同源,否则"驼峰+走了出口"的错没人看守)。
+ boolean takesCompanyParam = handler.takesCompanyParam();
+ // 断言 A:收了公司 id 参数的 handler 必须在该 handler 体内走唯一出口(handler 级豁免)。
+ if (takesCompanyParam && !READ_SCOPE_ALLOWLIST.contains(exemptionKey(rel, handler))) {
assertThat(handler.text())
.as(where + " 收了公司 id 参数,但该 handler 体内没有出现 readScope( —— 文件里别处接了不算")
.contains(READ_SCOPE_CALL);
}
- // 断言 B:块里出现 company_id 就必须写显式 name=(白名单不豁免这条)。
- if (handler.text().contains(SNAKE_PARAM)) {
+ // 断言 B:收了公司 id 参数的 handler 必须写显式 name=(白名单不豁免这条)。
+ if (takesCompanyParam) {
assertThat(handler.text())
- .as(where + " 的 company_id 没写显式 name=,会和驼峰参数名混成两种拼写")
+ .as(where + " 的公司 id 参数没写显式 name = \"company_id\"")
.contains(EXPLICIT_PARAM_NAME);
}
}
@@ -149,17 +176,29 @@ class CompanyIdParamGoesThroughReadScopeTest {
}
@Test
- @DisplayName("白名单每一项都仍在取样集里:条目一旦不再含公司 id 形状就红(防僵尸豁免)")
+ @DisplayName("白名单每一项都仍对应一个真在收公司 id 的 handler:条目失效或被豁免文件冒出第二记都红(防僵尸豁免/整文件级豁免)")
void allowlistEntriesAreStillSampled() throws IOException {
- Set sampledKeys = sampledControllers().stream()
- .map(CompanyIdParamGoesThroughReadScopeTest::relativeKey)
- .collect(Collectors.toSet());
- assertThat(sampledKeys)
- .as("白名单里的文件已经不含 company_id/companyId 端点了,请把这条豁免一起删掉")
+ Set companyHandlerKeys = companyScopedHandlerKeys();
+
+ assertThat(companyHandlerKeys)
+ .as("白名单条目对应的 handler 已经不收公司 id 参数了(改名/删端点/参数换形状),请把这条豁免一起删掉")
.containsAll(READ_SCOPE_ALLOWLIST);
+
+ // 降级到 handler 级后新增的看守:被豁免点名过的文件里,每一个收公司 id 的 handler 都必须自己点名,
+ // 否则就是"以为整文件被豁免、其实只免了一条"的第二记端点——必须红,不许靠 hasSize(1) 蒙混。
+ Set exemptedFiles = READ_SCOPE_ALLOWLIST.stream()
+ .map(CompanyIdParamGoesThroughReadScopeTest::filePartOf)
+ .collect(Collectors.toSet());
+ List unNamedInExemptedFile = companyHandlerKeys.stream()
+ .filter(key -> exemptedFiles.contains(filePartOf(key)))
+ .filter(key -> !READ_SCOPE_ALLOWLIST.contains(key))
+ .collect(Collectors.toList());
+ assertThat(unNamedInExemptedFile)
+ .as("被豁免点名的文件里出现了第二个收公司 id 的 handler,却没被单独点名——豁免是 handler 级,不是整文件级")
+ .isEmpty();
}
- /** 取样=可执行行里出现下划线字面量,或同一行的 @RequestParam 用了驼峰 companyId。 */
+ /** 取样=可执行行里出现公司 token(下划线或驼峰),逐 handler 的窗口谓词再判定是否真收参数。 */
private static List sampledControllers() throws IOException {
if (!Files.isDirectory(MAIN_ROOT)) fail("找不到 " + MAIN_ROOT + " —— 用例依赖以 backend-java 为工作目录");
try (Stream walk = Files.walk(MAIN_ROOT)) {
@@ -172,14 +211,51 @@ class CompanyIdParamGoesThroughReadScopeTest {
}
}
- /** 断言 A 的触发条件:必须是"参数"形状(同一行有 @RequestParam),不是任意出现。 */
- private static boolean isCompanyParamLine(String line) {
- return line.contains(REQUEST_PARAM) && (line.contains(SNAKE_PARAM) || line.contains(CAMEL_PARAM));
+ /** 全部"收公司 id 参数"的 handler 的豁免键集合。 */
+ private static Set companyScopedHandlerKeys() throws IOException {
+ Set keys = new HashSet<>();
+ for (Path controller : sampledControllers()) {
+ String rel = relativeKey(controller);
+ for (Block handler : splitBlocks(executableLines(read(controller))).handlers()) {
+ if (handler.takesCompanyParam()) keys.add(exemptionKey(rel, handler));
+ }
+ }
+ return keys;
}
- /** 取样与残块的触发条件。 */
+ /** handler 级豁免键:相对路径 + '#' + 该 handler 自己的 mapping 注解文本。 */
+ private static String exemptionKey(String rel, Block handler) {
+ return rel + "#" + handler.mappingLine();
+ }
+
+ private static String filePartOf(String key) {
+ int hash = key.indexOf('#');
+ return hash < 0 ? key : key.substring(0, hash);
+ }
+
+ /** 取样与残块的触发条件:可执行行里出现公司 token(下划线或驼峰)。 */
private static boolean isCompanyShapeLine(String line) {
- return line.contains(SNAKE_PARAM) || (line.contains(REQUEST_PARAM) && line.contains(CAMEL_PARAM));
+ return hasCompanyToken(line);
+ }
+
+ private static boolean hasCompanyToken(String line) {
+ return line.contains(SNAKE_PARAM) || line.contains(CAMEL_PARAM);
+ }
+
+ private static boolean isMappingLine(String line) {
+ return MAPPING_ANNOTATIONS.stream().anyMatch(line::startsWith);
+ }
+
+ /**
+ * 文档串行:{@code @Operation}/{@code @Parameter}/{@code @ApiResponse} 或带 {@code summary =}/
+ * {@code description =} 的注解行——这些里出现的 companyId 只是文案,不代表该 handler 真收了公司参数。
+ */
+ private static boolean isDocLine(String line) {
+ return line.startsWith("@Operation")
+ || line.startsWith("@Parameter")
+ || line.startsWith("@ApiResponse")
+ || line.contains("summary =")
+ || line.contains("description =");
}
/**
@@ -198,7 +274,7 @@ class CompanyIdParamGoesThroughReadScopeTest {
int runEnd = i;
while (runEnd + 1 < ex.size() && ex.get(runEnd + 1).startsWith("@")) runEnd++;
boolean mappingRun = ex.subList(i, runEnd + 1).stream()
- .anyMatch(line -> MAPPING_ANNOTATIONS.stream().anyMatch(line::startsWith));
+ .anyMatch(CompanyIdParamGoesThroughReadScopeTest::isMappingLine);
String signature = runEnd + 1 < ex.size() ? ex.get(runEnd + 1) : "";
if (mappingRun && !signature.isEmpty() && !TYPE_DECL.matcher(signature).find()) {
starts.add(i);
@@ -224,8 +300,47 @@ class CompanyIdParamGoesThroughReadScopeTest {
return String.join("\n", lines);
}
+ /** 该 handler 的 mapping 注解文本,作为 handler 级豁免键的后缀;没有 mapping 行就退回块首行。 */
+ String mappingLine() {
+ return lines.stream()
+ .filter(CompanyIdParamGoesThroughReadScopeTest::isMappingLine)
+ .findFirst()
+ .orElse(lines.get(0));
+ }
+
+ /**
+ * 声明窗口:从本块的 mapping 注解行起、到第一个以 { 结尾的行为止(含该行)。
+ * 返回 {@code null} 表示整块找不到以 { 结尾的行(切块形状失效),由调用方判红并报块名。
+ */
+ List declarationWindow() {
+ int start = 0;
+ while (start < lines.size() && !isMappingLine(lines.get(start))) start++;
+ for (int j = start; j < lines.size(); j++) {
+ if (lines.get(j).endsWith(WINDOW_OPEN)) {
+ return lines.subList(start, j + 1);
+ }
+ }
+ return null;
+ }
+
+ boolean windowUndeterminable() {
+ return declarationWindow() == null;
+ }
+
+ /**
+ * 该 handler 是否收公司 id 参数(A、B 共用,N1 要求同源):
+ * ① 声明窗口里同时出现 {@code @RequestParam} 与非文档行的公司 token(覆盖 inline 与折行签名,
+ * 排除 {@code @Operation}/{@code description=} 里的文案提及);
+ * ② 或整块里出现 {@code request.getParameter("company_id"/"companyId")} 同族写法(这一族写在方法体内)。
+ */
boolean takesCompanyParam() {
- return lines.stream().anyMatch(CompanyIdParamGoesThroughReadScopeTest::isCompanyParamLine);
+ List window = declarationWindow();
+ boolean viaRequestParam = window != null
+ && window.stream().anyMatch(line -> line.contains(REQUEST_PARAM))
+ && window.stream().anyMatch(line -> hasCompanyToken(line) && !isDocLine(line));
+ boolean viaGetParameter = lines.stream()
+ .anyMatch(line -> line.contains(GET_PARAMETER) && hasCompanyToken(line));
+ return viaRequestParam || viaGetParameter;
}
}
@@ -241,7 +356,7 @@ class CompanyIdParamGoesThroughReadScopeTest {
.collect(Collectors.toList());
}
- /** 白名单键:相对 src/main/java、统一正斜杠,与取样路径同源,避免平台分隔符造成静默不匹配。 */
+ /** 白名单键的文件部分:相对 src/main/java、统一正斜杠,与取样路径同源,避免平台分隔符造成静默不匹配。 */
private static String relativeKey(Path controller) {
return MAIN_ROOT.relativize(controller).toString().replace('\\', '/');
}