diff --git a/docs/plans/19-company-tab.md b/docs/plans/19-company-tab.md index c355e25cd..610365d80 100644 --- a/docs/plans/19-company-tab.md +++ b/docs/plans/19-company-tab.md @@ -2195,6 +2195,13 @@ public final class SourceScan { // 值在 paramNameValuePairs 里,segment 里只有 MPGENVAL 占位 ⇒ 结构从 segment 读、值从 pairs 读。 assertThat(captor.getValue().getSqlSegment()).contains("created_by_id").contains("IN ("); assertThat(captor.getValue().getParamNameValuePairs().values()).contains(11L, 12L); + // ⚠️ 执行期补(Task 11 修复轮 2,评审 F5):**超管**分支这两句不是恒真(那串里两个 contains 只可能来自公司腿), + // 但**非超管**那块 `query.and(wrapper -> created_by_id IN (…) OR group_id IN (…))` 本 Step 没给用例 ⇒ + // 平铺它实测 `8 例全绿、rc=0`(同样是"错了不报错、只多放行")。已另写一支 + // nonSuperAdminVisibleSetOrIsBracketedBeforeCompanyLeg 用同一把尺子(脱敏整串逐字比对)钉住,实测串: + // ((created_by_id IN (?) OR group_id IN (?)) AND created_by_id IN (?,?)) ORDER BY id DESC LIMIT 0, 15 + // (注意公司腿这一形是**平铺**的 `AND created_by_id IN (?,?)`、外面只有一层白送括号——与上面分组侧那形不同, + // 别照抄串;一切以实跑打印为准。) } @Test @@ -2208,11 +2215,19 @@ public final class SourceScan { ArgumentCaptor.forClass(LambdaQueryWrapper.class); verify(groupMapper).selectList(captor.capture()); String segment = captor.getValue().getSqlSegment(); - // 断"OR 被包在 and( ... ) 里"的形状:OR 之前必须出现一个 '(',且整段以 AND (…IN…) 收尾。 - assertThat(segment).contains("(created_by_id").contains(" OR "); - assertThat(segment.lastIndexOf("AND (")) - .as("公司条件必须自成一组,不能与 OR 平铺") - .isGreaterThan(segment.indexOf("created_by_id")); + // 断"OR 被包在 and( ... ) 里"的形状。⚠️ 执行期订正(Task 11 修复轮 2,评审 I-1/F1–F3): + // 原写法 contains("(created_by_id") + lastIndexOf("AND (") > indexOf("created_by_id") **两句都恒真**—— + // "(created_by_id" 有两个白送来源:①公司腿自己的 `AND (created_by_id IN (`;②MP 的 + // NormalSegmentList.childrenSqlSegment() 无条件给整段 normal 套一对最外层括号 + // (LEFT_BRACKET + str + RIGHT_BRACKET),实测连平铺实现也含开头的 "(";而 lastIndexOf("AND (") + // 只量到"公司条件自成一组",杀平铺纯属顺带命中。⇒ 把 :57 那条 OR 改回平铺,全仓 16 例照绿。 + // 主锚改成**脱敏后整串逐字比对**,字面量来自实跑打印的 getSqlSegment()(不是推理): + String masked = segment.replaceAll("#\\{ew\\.paramNameValuePairs\\.MPGENVAL\\d+}", "?"); + assertThat(masked).isEqualTo( + "((created_by_id = ? OR (user_id = ?)) AND (created_by_id IN (?))) ORDER BY id ASC"); + // 分组括号与"白送括号"的差就是那**第二对**——正确实现两对、平铺一对,整串恰好量这一维。 + // 代价(明写):绑死 MP 3.5.7 的渲染形态与占位符个数 ⇒ 升级 MP 或改分页会**假红**(不是假绿), + // 处置是重跑探针重取串,不许手改字面量。值仍旧单独从 getParamNameValuePairs() 断。 } @Test @@ -2454,9 +2469,21 @@ SELECT source, COUNT(*) FROM device_log_file GROUP BY source; service().page(null, null, null, null, 1L, 20L, List.of(11L, 12L)); AbstractWrapper q = capturedCount(); - assertThat(q.getSqlSegment()) + String seg = q.getSqlSegment(); + assertThat(seg) .as("必须是 (source = ? OR uid IN (...)) 一整组,括号丢了就等于把麦象筛掉") - .contains(" OR ").contains("IN ("); + .contains(" OR ").contains("IN (") + // ⚠️ 执行期订正(Task 12 修复轮 1,评审 I-1):上面那两句**平铺实现照样全满足** ⇒ 那句 .as 声称的 + // 检查并没有被执行。但"补 contains(\"(source =\")"也不行——MP 3.5.7 给整段 WHERE 白送一对最外层括号, + // 平铺实测原文是 `(source = ? OR uid IN (?,?) AND log_date >= ?)`,那句恒真。 + // 判据必须**数到第二对括号**,并排掉"半开"那形(`.and(w->eq).or(o->in)` 照样含 `AND (source =`, + // 但 OR 已在组外): + .contains("((source =") // 分组实测原文以两对括号开头(REAL-1) + .doesNotContain(") OR "); // 一出现 ") OR " 就说明 OR 的左半边被括在组外 + // 实跑原文(脱敏后):((source = ? OR (uid IN (?,?))) AND log_date >= ?) + // 「外层条件 + OR 组并存」那一支(companyFilterStacks…)换一组锚:contains("AND (source =") + // + doesNotContain(") OR ") + indexOf("AND (") < indexOf(" OR ")(原文 REAL-2: + // (source = ? AND (source = ? OR (uid IN (?,?))) AND log_date >= ?))。 // 值落在 paramNameValuePairs 里,不在 getSqlSegment() 里——别写成 segment.contains("maixiang"), // MP 渲染的是 #{ew.paramNameValuePairs.MPGENVAL1},那条断言恒假。 assertThat(q.getParamNameValuePairs().values()).contains("maixiang", 11L, 12L); @@ -2510,11 +2537,12 @@ SELECT source, COUNT(*) FROM device_log_file GROUP BY source; } ``` -**读法三条,都是这组用例能不能咬住实现的关键:** +**读法四条,都是这组用例能不能咬住实现的关键:** 1. `selectCount` **一定**被打到,`selectList` 只在 `total != 0` 时才打(`DeviceLogService.java:189-193` 的三元)。所以凡是"看生成的条件"的用例,要么把 `selectCount` 桩成 `1L` 再捕两支,要么直接捕 `selectCount` 那支——别写一个"selectCount 桩 0 然后断言 selectList 的 wrapper"的用例,它捕到的是 null,红在断言之前。 2. MP 把值放进 `paramNameValuePairs`,`getSqlSegment()` 里只有 `#{ew.paramNameValuePairs.MPGENVAL1}` 这种占位。⇒ **结构**(括号、`OR`、`IN`)从 segment 读,**值**(`"maixiang"`、`11L`)从 `getParamNameValuePairs().values()` 读。写成 `segment.contains("maixiang")` 是恒假断言(memory「字符串断言必须排他、解析断言必须可匹配」)。**同一条还有后半截:`paramNameValuePairs` 是惰性填的**——MP 3.5.7 把值装进 `() -> formatParam(null, val)` 这样的 lambda,只有 `getSqlSegment()` 被求值过一次,pairs 里才落值。所以凡断 pairs 的用例必须**先取一次 segment** 再读 pairs;反过来写(Task 12 实跑撞过)会拿到 `[]`,于是 `doesNotContain(...)` 恒真、`两支的 pairs 相等` 变成「两个空 map 相等」也恒真——尺子绿着,什么都没钉住。 3. `capturedCount()` / `capturedList()` 各用一个 `ArgumentCaptor>` 捕(本文件已 import `ArgumentCaptor` 与 `AbstractWrapper`),捕获后 `(AbstractWrapper)` 转型取 `getSqlSegment()`。`row(1024L, 2)` 用文件里已有的助手即可——这几条测的是**生成的 SQL 形状**,不是返回内容,所以不需要给行设 `source`/`uid`。 +4. **`contains("(列名")` 这一族判据一律不能用**(Task 11 修复轮 2 + Task 12 修复轮 1 各撞一次,两轮实测):MP 3.5.7 的 `NormalSegmentList.childrenSqlSegment()` 是 `join(" ")` 外面**无条件**套 `(` + `)`——整段 WHERE 白送一对最外层括号,**平铺实现照样含开头的 `(`**。于是 `contains("(created_by_id")`、`contains("(source =")` 在它声称要防的形状上恒真;`lastIndexOf("AND (") > indexOf(列名)` 只量到"公司条件自成一组",杀平铺属顺带命中。⇒ 两条出路:①数到**第二对**括号(`contains("((source =")` / `contains("AND (source =")`)并叠 `doesNotContain(") OR ")` 排掉"半开"那形(`.and(w->eq).or(o->in)` 照样含 `AND (source =`,但 OR 已在组外);②**脱敏后整串逐字比对**——`segment.replaceAll("#\\{ew\\.paramNameValuePairs\\.MPGENVAL\\d+}", "?")` 再 `isEqualTo(实测串)`,字面量**只能来自实跑打印**(不许推理),且脱敏函数自带"占位符一个不剩"的自检(`doesNotContain("MPGENVAL").doesNotContain("#{")`),否则脱敏漏一种形状会退化成"整串恒不匹配"的糊涂红。②的代价要明写:绑死 MP 渲染形态与占位符个数 ⇒ 升级 MP/改分页算术时**假红(不是假绿)**,届时重跑探针重新取串,不许手改字面量。这一族的失败模式是"错了不报错、只多放行",所以宁可选会假红的尺子。 - [ ] **Step 2: 跑,确认红**