feat(容忍): 在跑判定 countLiveWorkFor——三张表各带 15 分钟新鲜度、读失败 fail-closed

三段标量子查询相加而非 UNION(UNION 会因列级排序规则差异报 1271)。
清单口径来自生产 information_schema 普查而非扫迁移文件:后者实测恒漏报
(V1 建表列名不带反引号、老表 user_id 来自后续 ALTER、现网有 dump 重建漂移),
静默少报的尺子比没尺子更糟,故改为「登记的表必须出现在 SQL 里」的对照钉。
This commit is contained in:
2026-10-09 14:43:47 +08:00
parent 3c86d7090f
commit d349bc1a7d
3 changed files with 124 additions and 0 deletions
@@ -0,0 +1,94 @@
package com.nanri.aiimage.common.mapper;
import com.baomidou.mybatisplus.core.MybatisConfiguration;
import com.nanri.aiimage.testutil.MapperXmlSupport;
import org.apache.ibatis.mapping.BoundSql;
import org.apache.ibatis.mapping.MappedStatement;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.TreeSet;
import static org.assertj.core.api.Assertions.assertThat;
/**
* 容忍闸只认「真的有任务在跑」。这张清单必须由迁移文件反推,不许手写——手写会漏:
* 设计阶段我只想到 biz_file_task 与 brand_crawl_tasks,实测 biz_price_track_loop_run 也在跑同类任务。
*/
class AdminUserLiveWorkSqlTest {
private static MybatisConfiguration configuration;
/** 计入容忍的三张表;少一张就有一类任务在跑却拿不到容忍。 */
private static final List<String> IN_SCOPE_LIVE_TABLES = List.of(
"biz_file_task", "brand_crawl_tasks", "biz_price_track_loop_run");
/** 有 user_id+status 但刻意排除的表,理由必须写在这里,不然下一个人会"顺手补上"。 */
private static final List<String> EXCLUDED_TABLES = List.of(
"biz_image_video_async_task", // 状态域里只有 SUCCESS,无「在跑」态
"biz_collectdata_brand_recheck" // 服务端自排队的品牌补测,PENDING 多在退避期,计入=长期持证
);
@BeforeAll
static void setUp() throws IOException {
// addMapper() 只装 BaseMapper 内置方法,自定义语句要由 MapperXmlSupport 把同名 XML 装进来
configuration = MapperXmlSupport.configurationWith(AdminUserMapper.class);
}
private static String sqlOf(String method, Map<String, Object> params) {
MappedStatement statement = configuration.getMappedStatement(
AdminUserMapper.class.getName() + "." + method);
BoundSql boundSql = statement.getBoundSql(params);
return boundSql.getSql().replaceAll("\\s+", " ").trim();
}
@Test
void onlyTheThreeLiveTablesAreCounted() {
String sql = sqlOf("countLiveWorkFor", Map.of("userId", 7L, "deviceId", "d"));
assertThat(sql).contains("biz_file_task").contains("brand_crawl_tasks")
.contains("biz_price_track_loop_run");
assertThat(sql).doesNotContain("biz_collectdata_brand_recheck")
.doesNotContain("biz_image_video_async_task")
.doesNotContain("py_Task"); // 麦象排队态写在另一个库,本期不算(spec §4)
assertThat(sql).contains("'RUNNING'").contains("'running'"); // 大小写两种都是实测状态域
// 三段子查询各自都要带新鲜度界:少写一段就是那张表永久持证
assertThat(sql.split("updated_at >= NOW\\(\\) - INTERVAL 15 MINUTE", -1).length - 1)
.isEqualTo(IN_SCOPE_LIVE_TABLES.size());
}
/**
* 清单一致性:在跑集合里的每张表都必须真的出现在渲染后的 SQL 里,被排除的每张都必须不出现。
*
* <p>这里刻意【不】去扫迁移文件反推「哪些表同时有 user_id 与 status」——试过,且它恒漏报:
* V1 时代的建表语句列名不带反引号、老表的 {@code user_id} 是后续 ALTER 加的、
* 而现网还有 dump 重建造成的历史漂移({@code biz_file_task} 与 {@code brand_crawl_tasks}
* 就扫不出来)。一把静默少报的尺子比没有尺子更糟:它会在"新任务类型拿不到容忍"那天正好显示全绿。
* 分母的权威来源是生产 {@code information_schema} 的只读普查(命令见本类底部注释与
* docs/superpowers/plans/2026-10-09-session-tolerance-while-task-running.md),
* 新增同类表时必须同时改上面两个清单和本条 SQL,评审时对这两处各提一次问题即可。</p>
*/
@Test
void classificationMatchesRenderedSql() {
String sql = sqlOf("countLiveWorkFor", Map.of("userId", 7L, "deviceId", "d"));
for (String table : IN_SCOPE_LIVE_TABLES) {
assertThat(sql).withFailMessage("表 %s 登记为在跑集合,却没出现在 SQL 里——这类任务拿不到容忍", table)
.contains(table);
}
for (String table : EXCLUDED_TABLES) {
assertThat(sql).withFailMessage("表 %s 已被显式排除,不应出现在 SQL 里", table).doesNotContain(table);
}
}
/*
* 分母普查(只读,随计划复核一起跑):
* PYTHONUTF8=1 python scripts/_probe_notif_anomaly_scan.py --sqlfile <(见计划 §Task 3 Step 1)
* 2026-10-09 实测:全库有 status 列的表 12 张(已排除 *_bak_*),其中同时有 user_id 的 7 张 =
* 本类两个清单之和 5 张 + 2 张 _bak_e2e_20261006 备份表(备份表不参与判定,故不出现在上面)。
*/
}