test(公司tab): 两把尺子补洞——范围"算过"要"用出去",company_id 要写明取值口

评审用变异证明现有护栏各有半个洞,而这两个洞接下来会被 Task 9–12 六页照抄,
所以在本任务收口,不留到批次尾。

- G2 断言 C:handler 里 `readScope(` 的结果必须先赋给变量、再出现在另一条方法调用的
  实参列表里。原来只断"体内出现了 readScope(",于是 `listHistory(…, scoped)` 改成
  `listHistory(…, null)` 时 20 支用例一支不红(控制方实测 rc=0)——范围算了又丢掉,
  页面照样看全量。`if (scoped != null) throw` 这类装饰不算接住。带 2 支负探针 + 1 支
  正探针 + 第二形探针,分母三条自检(取样集非空 / 走完两步的支数为正 / 射程必须覆盖
  已接线的两页),不许恒绿也不许恒红。
- G1 取值口登记表:`/company_id\s*[:=]/` 对"右半边从哪个对象读"是瞎的,
  `= normalized.companyId` 与 baseline 缺口清单逐字相同(normalizeHistoryParams 是
  白名单构造,运行时恒 undefined)。每页登记该页 api 函数自己的入参形状;8 页全覆盖、
  缺条目红、接了线没登记同样红——没有"未登记就退回宽松判据"的默认分支。
- helpers.readSource 归一行尾:仓库 autocrlf=true,新检出是 CRLF 而源码 blob 是 LF,
  `[\s\S]{0,N}` 这类有界窗口会被多出来的 `\r` 挤红——同一份 company-tab store
  (LF 3565B / CRLF 3629B,内容等价)在干净检出树上多红一条无关用例。归一后实测
  CRLF 树回到 6/5/1(只剩批次那条刻意留红)。

读数:后端全量 3663/0/0 Skipped 7 BUILD SUCCESS(最终字节亲跑);定向 9/0,变异
`scoped`→`null` 后 1 Failures 红在 CompanyIdParamGoesThroughReadScopeTest:393;
前端全量 1726/1725/1、`vue-tsc` rc=0;`= normalized.companyId`(连守卫一起换的静默变体)
实测红且点名 admin_history。产品码一支未动。
This commit is contained in:
2026-10-05 10:11:08 +08:00
parent 83a444def6
commit 265f31681f
3 changed files with 326 additions and 3 deletions
@@ -10,6 +10,7 @@ import java.util.ArrayList;
import java.util.HashSet;
import java.util.List;
import java.util.Set;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import java.util.stream.Collectors;
import java.util.stream.Stream;
@@ -85,6 +86,15 @@ import org.junit.jupiter.api.Test;
* 可观察证据;私有辅助方法或字段里提一句 {@code companyId}(Task 11 就会写)不再误伤。
* 取舍写在这里:这样会漏掉"公司 token 落在 handler 之外但形状不像参数声明"那一族(如类级常量),
* 那一族交给人审与变异测试,换的是"不红在无关代码上"。</li>
* <li><b>算了范围不等于接了出口</b>(复评 I-1;修复轮 1 新增的断言 C)。断言 A 只看 handler 体内有没有
* {@code readScope(} 这个字面量,于是 {@code listHistory(page, pageSize, userId, timeStart, timeEnd,
* scoped)} 的末位实参被改成 {@code null} 时 A、B 全绿——控制方实测 rc=0、9 支用例一支不红。
* 范围"算过"而没"用出去",页面照样看全量。断言 C 因此钉两步:
* ① {@code readScope(} 的结果必须<b>被赋值给一个变量</b>({@code List<Long> scoped = …readScope(…);} 与
* {@code ReadScope s = …readScope(…);} 两种形状都认);找不到赋值目标 = 裸语句、结果被丢掉 ⇒ 红。
* ② 该变量必须出现在 handler 体内<b>另一条方法调用的实参列表</b>里(扣掉它自己那条赋值语句,
* 单层括号够用,今天两页都是这一形)。只要求"在别处被引用一次"不够:
* {@code if (scoped != null) throw …} 是装饰,不算把范围交给谁 ⇒ 控制语句关键字不认。</li>
* </ol>
*
* <p>取样键:可执行行里出现 {@code company_id} <b>或</b> {@code companyId}(裸 token 即入样本,交给逐 handler
@@ -120,6 +130,16 @@ class CompanyIdParamGoesThroughReadScopeTest {
private static final Set<String> READ_SCOPE_ALLOWLIST =
Set.of("com/nanri/aiimage/modules/admin/controller/AdminUserController.java#@GetMapping(\"/users\")");
/**
* 断言 C 的<b>射程下限</b>(复评 I-1):Task 8 已经接线的两页必须真被 C 扫到。
* 不钉这一条的话,"取样集非空"自检可以由任何一支别的 handler 满足,而这两页哪天改了
* mapping 注解 / 换了参数形状就会静默脱离射程——分母由本轮自己造,等于没有分母。
*/
private static final String SCOPE_CAUGHT_HISTORY_KEY =
"com/nanri/aiimage/modules/imagehistory/controller/ImageHistoryController.java#@GetMapping(\"/history\")";
private static final String SCOPE_CAUGHT_VIDEO_KEY =
"com/nanri/aiimage/modules/imagevideo/controller/AdminImageVideoTaskController.java#@GetMapping";
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";
@@ -128,6 +148,27 @@ class CompanyIdParamGoesThroughReadScopeTest {
private static final String GET_PARAMETER = "getParameter(";
private static final String WINDOW_OPEN = "{";
private static final String CLOSE_BRACE = "}";
private static final String SEMICOLON = ";";
/**
* 断言 C 第 ① 步的赋值形状:{@code 标识符 =}。比较运算符吃不到——{@code a == b} 的两个 {@code =}
* 前面都不是标识符尾字符({@code =}/{@code空格=} 前面是 {@code =}),{@code !=}/{@code <=}/{@code >=}
* 同理中间隔了别种符号,{@code (ident)\s*=(?!=)} 匹配不上。取<b>最后一个</b>匹配:
* {@code List<Long> scoped = dataReadScope.readScope(…)} 里 {@code Long} 后面跟的是 {@code >},
* 不会被当成目标,目标只能是 {@code scoped}。
*/
private static final Pattern SCOPE_ASSIGNMENT = Pattern.compile("([A-Za-z_$][\\w$]*)\\s*=(?!=)");
/** 断言 C 第 ② 步的消费形状:{@code 名字(实参)},单层括号(现有两页都是这一形)。 */
private static final Pattern CALL_ARGUMENTS =
Pattern.compile("([A-Za-z_$][\\w$]*)\\s*\\(([^()]*)\\)");
/**
* 控制语句关键字:读了变量但<b>没把它交给任何人</b>。{@code if (scoped != null) throw …} 这种装饰
* 若算"接住了",C 就等于没写(复评点名的正是这一族)。
*/
private static final Set<String> NOT_VALUE_CONSUMERS = Set.of(
"if", "for", "while", "switch", "do", "catch", "synchronized", "return", "throw", "else", "try");
/**
* 参数绑定注解(F-A):一行里出现它们,这一行就是<b>真参数声明</b>,无论同行是否还写着
@@ -171,6 +212,50 @@ class CompanyIdParamGoesThroughReadScopeTest {
}
""";
/**
* 断言 C 的负探针 1:{@code readScope(} 写成裸语句、结果当场丢掉——第 ① 步就该红。
* 这合法 Java(方法调用是合法的表达式语句),不是为了让探针"看起来像坏代码"。
*/
private static final String SCOPE_DISCARD_PROBE = """
@GetMapping("/probe")
public String discard(@RequestParam(name = "company_id", required = false) Long companyId) {
dataReadScope.readScope(null, companyId);
return "ok";
}
""";
/** 断言 C 的负探针 2:变量接住了,但只在 {@code if} 里装饰一次,没交给任何方法调用——第 ② 步该红。 */
private static final String SCOPE_DECOR_PROBE = """
@GetMapping("/probe")
public String decor(@RequestParam(name = "company_id", required = false) Long companyId) {
List<Long> scoped = dataReadScope.readScope(null, companyId).userIdsOr(null);
if (scoped != null) throw new IllegalStateException("x");
return "ok";
}
""";
/**
* 断言 C 的另一种赋值形状探针:{@code ReadScope s = …readScope(…);}(规格点名的第二形)。
* 今天真树两页都是 {@code List<Long> scoped = …userIdsOr(base);},这一形还没有使用者,
* 但判据必须认它——否则哪天有人改成返回 ReadScope 的写法,红的是护栏而不是接线。
*/
private static final String SCOPE_TYPE_FORM_PROBE = """
@GetMapping("/probe")
public String typed(@RequestParam(name = "company_id", required = false) Long companyId) {
ReadScope s = dataReadScope.readScope(null, companyId);
return String.valueOf(imageVideoAdminTaskService.page(1, 20, s));
}
""";
/** 断言 C 的正探针:接住并且进了另一条调用的实参列表 ⇒ 判据不许恒红。 */
private static final String SCOPE_CAUGHT_PROBE = """
@GetMapping("/probe")
public String caught(@RequestParam(name = "company_id", required = false) Long companyId) {
List<Long> scoped = dataReadScope.readScope(null, companyId).userIdsOr(null);
return String.valueOf(imageHistoryService.listHistory(1, 15, null, null, null, scoped));
}
""";
@Test
@DisplayName("每个收公司 id 参数的 handler 都走唯一出口,并且显式写了 name = \"company_id\"")
void everyCompanyIdHandlerGoesThroughReadScope() throws IOException {
@@ -206,6 +291,29 @@ class CompanyIdParamGoesThroughReadScopeTest {
.as("块边界自检的反面证据:readScope( 确实写在收口之后的尾随方法里")
.contains(READ_SCOPE_CALL);
// 断言 C 的判据自检(全局约束 15:每条判据都要有"能红"与"能绿"两个方向的证据):
// 两个负探针必须各自红在第 ①/② 步、一个正探针必须绿,且三个探针都得先被切成
// "1 支 handler + 真收公司 id 参数 + 体内真写了 readScope(" —— 这三条不成立下面的断言就是空跑。
assertThat(scopeProbeReason(SCOPE_DISCARD_PROBE, "SCOPE_DISCARD_PROBE"))
.as("断言 C 自检(负样本 1,第 ① 步):readScope( 写成裸语句、结果被丢掉时必须判红")
.isNotNull()
.contains("范围算了但没接住");
assertThat(scopeProbeReason(SCOPE_DECOR_PROBE, "SCOPE_DECOR_PROBE"))
.as("断言 C 自检(负样本 2,第 ② 步):范围赋给了变量但只在 if 里装饰一次、没交给任何方法调用 ⇒ 同样要红")
.isNotNull()
.contains("实参");
assertThat(scopeProbeReason(SCOPE_CAUGHT_PROBE, "SCOPE_CAUGHT_PROBE"))
.as("断言 C 自检(正样本):范围接住了并当实参传给了 service.listHistory ⇒ 判据不是恒红")
.isNull();
assertThat(scopeProbeReason(SCOPE_TYPE_FORM_PROBE, "SCOPE_TYPE_FORM_PROBE"))
.as("断言 C 自检(第二形):ReadScope s = dataReadScope.readScope(…) 且 s 进了 service.page(…) 的实参 ⇒ 同样要认")
.isNull();
// 断言 C 的分母由本轮实扫得出(不写死数字):扫进射程的 handler 键、走完两步的正样本支数、红因先攒后判。
List<String> scopeCaughtSample = new ArrayList<>();
List<String> scopeDiscarded = new ArrayList<>();
int scopeCaughtHandlers = 0;
List<Path> sampled = sampledControllers();
assertThat(sampled)
.as("取样集非空自检:一条都没扫到说明扫描失效,护栏等于没写")
@@ -242,6 +350,17 @@ class CompanyIdParamGoesThroughReadScopeTest {
.as(where + " 的公司 id 参数没写显式 name = \"company_id\"")
.contains(EXPLICIT_PARAM_NAME);
}
// 断言 C(复评 I-1):体内写了 readScope( 只说明"算过",不说明"用出去了"。
// 白名单只免 A 不免 C——被豁免的那支哪天自己算了个范围又丢掉,一样得红。
if (takesCompanyParam && handler.text().contains(READ_SCOPE_CALL)) {
scopeCaughtSample.add(exemptionKey(rel, handler));
String dropped = handler.scopeCatchFailure();
if (dropped == null) {
scopeCaughtHandlers++;
} else {
scopeDiscarded.add(where + dropped);
}
}
}
// 残块(package/import/类级注解/字段,以及 handler 收口之后、下一支 handler 之前的尾随方法)
@@ -256,6 +375,22 @@ class CompanyIdParamGoesThroughReadScopeTest {
.as(rel + " 的公司参数声明落在 handler 之外(切块没覆盖到,可能是类级注解/字段/尾随方法)—— 必须显式核对,不许静默跳过")
.isEmpty();
}
// 断言 C 的取样自检(全局约束 15):三个读数任一为 0 都是"护栏自己空转",用例必须当场红,
// 不许因为"这一轮没扫到东西"而恒绿,也不许靠放宽判据蒙过去。
assertThat(scopeCaughtSample)
.as("断言 C 取样集非空自检:一支『收了公司 id 参数、体内又写了 readScope(』的 handler 都没扫到")
.isNotEmpty();
assertThat(scopeCaughtHandlers)
.as("断言 C 正样本自检:扫到 " + scopeCaughtSample.size()
+ " 支 handler,走完『接住变量 → 当实参传出去』两步的是 0 支 —— 判据恒红或形状不认,不可信")
.isPositive();
assertThat(scopeCaughtSample)
.as("断言 C 的射程必须覆盖 Task 8 已接线的两页(改名/换 mapping 会让它静默脱离射程,分母不能自造)")
.contains(SCOPE_CAUGHT_HISTORY_KEY, SCOPE_CAUGHT_VIDEO_KEY);
assertThat(scopeDiscarded)
.as("范围算了但没接住(断言 C):readScope( 的结果要么没赋给变量,要么赋了却没交给任何方法调用")
.isEmpty();
}
@Test
@@ -281,6 +416,26 @@ class CompanyIdParamGoesThroughReadScopeTest {
.isEmpty();
}
/**
* 断言 C 的探针驱动器:先确认这段样本真被切成"1 支收公司 id 参数、体内写了 readScope(" 的 handler,
* 再跑 {@link Block#scopeCatchFailure()}。切不出 handler / 不认公司参数 / 没有 readScope( 这三种
* "探针失效"都由调用方的前置断言红,不留静默空跑。
*/
private static String scopeProbeReason(String probeSource, String probeName) {
List<Block> blocks = splitBlocks(sourceLines(probeSource)).handlers();
assertThat(blocks)
.as(probeName + " 应当恰好切出 1 支 handler;切不出来则断言 C 的自检无从判定")
.hasSize(1);
Block handler = blocks.get(0);
assertThat(handler.takesCompanyParam())
.as(probeName + " 的 handler 没被认成收公司 id 参数,断言 C 根本不会触发 ⇒ 探针失效")
.isTrue();
assertThat(handler.text())
.as(probeName + " 的 handler 体内没有 readScope( ,断言 C 扫不到它 ⇒ 探针失效")
.contains(READ_SCOPE_CALL);
return handler.scopeCatchFailure();
}
/** 取样=可执行行里出现公司 token(下划线或驼峰),逐 handler 的窗口谓词再判定是否真收参数。 */
private static List<Path> sampledControllers() throws IOException {
if (!Files.isDirectory(MAIN_ROOT)) fail("找不到 " + MAIN_ROOT + " —— 用例依赖以 backend-java 为工作目录");
@@ -555,6 +710,65 @@ class CompanyIdParamGoesThroughReadScopeTest {
boolean takesCompanyParam() {
return viaRequestParam() || viaGetParameter();
}
/**
* 断言 C(复评 I-1):这一支 handler 里每一次 {@code readScope(} 都必须
* ① 把结果<b>赋给一个变量</b>(认 {@code List<Long> scoped = …readScope(…).userIdsOr(base);}
* 与 {@code ReadScope s = …readScope(…);} 两种形状,也认不带类型的重新赋值 {@code scoped = …});
* ② 让那个变量出现在<b>另一条方法调用的实参列表</b>里(自己那条赋值语句先从文本里扣掉,
* 免得 {@code readScope(operator, scopedCompanyId)} 之类自指算数)。
* <p>返回 {@code null} = 两步都过;否则返回红因片段,由调用方拼上 handler 名。
* <p>已知放过的那一族:把变量喂给 {@code log.info("…", scoped)} 也算"给了实参"。要做成
* "只有交给 service/mapper 那一层才算"就得枚举消费者名字,那是第二把尺子,本轮不做,交人审。
*/
String scopeCatchFailure() {
String src = text();
for (int at = src.indexOf(READ_SCOPE_CALL); at >= 0;
at = src.indexOf(READ_SCOPE_CALL, at + READ_SCOPE_CALL.length())) {
// 语句边界:往前取最近的 ';' 或 '{'(方法体开行),往后取第一个 ';'。
int stmtStart = Math.max(src.lastIndexOf(SEMICOLON, at), src.lastIndexOf(WINDOW_OPEN, at)) + 1;
int stmtEnd = src.indexOf(SEMICOLON, at);
String statement = stmtEnd < 0 ? src.substring(stmtStart) : src.substring(stmtStart, stmtEnd + 1);
String target = assignedTo(statement, at - stmtStart);
if (target == null) {
return " 的 readScope( 是条裸语句:算完了没赋给任何变量,范围算了但没接住"
+ "(要写成 List<Long> scoped = dataReadScope.readScope(…)…; 再把 scoped 交出去)";
}
String rest = src.substring(0, stmtStart) + (stmtEnd < 0 ? "" : src.substring(stmtEnd + 1));
if (!passedAsArgument(rest, target)) {
return " 的 readScope( 结果赋给了 `" + target + "`,但 handler 体内没有任何方法调用的"
+ "实参列表用到 `" + target + "`:范围接住了却没交出去(把 service 那层的实参改成 "
+ "null 就是这个形状)";
}
}
return null;
}
/** 赋值目标={@code readScope(} 之前最后一个 {@code 标识符 =}({@code == != <= >=} 不算赋值)。 */
private static String assignedTo(String statement, int readScopeOffset) {
int cut = Math.max(0, Math.min(readScopeOffset, statement.length()));
Matcher m = SCOPE_ASSIGNMENT.matcher(statement.substring(0, cut));
String target = null;
while (m.find()) {
target = m.group(1);
}
return target;
}
/** {@code id} 有没有落在某个 {@code 名字(…)} 的实参列表里;控制语句关键字读它不算"交出去"。 */
private static boolean passedAsArgument(String src, String id) {
Matcher call = CALL_ARGUMENTS.matcher(src);
Pattern use = Pattern.compile("(?<!\\w)" + Pattern.quote(id) + "(?!\\w)");
while (call.find()) {
if (NOT_VALUE_CONSUMERS.contains(call.group(1))) {
continue;
}
if (use.matcher(call.group(2)).find()) {
return true;
}
}
return false;
}
}
/** 源码行:{@code text} 已 trim(口径同仓内既有过滤器),{@code indent} 保留原始缩进(块边界靠它收口)。 */