feat(容忍): 在跑判定 countLiveWorkFor——三张表各带 15 分钟新鲜度、读失败 fail-closed
三段标量子查询相加而非 UNION(UNION 会因列级排序规则差异报 1271)。 清单口径来自生产 information_schema 普查而非扫迁移文件:后者实测恒漏报 (V1 建表列名不带反引号、老表 user_id 来自后续 ALTER、现网有 dump 重建漂移), 静默少报的尺子比没尺子更糟,故改为「登记的表必须出现在 SQL 里」的对照钉。
This commit is contained in:
@@ -32,4 +32,16 @@ public interface AdminUserMapper extends BaseMapper<AdminUserEntity> {
|
||||
* 的下发集要用同一个公司口径,否则两处各判一次就留下静默死链。</p>
|
||||
*/
|
||||
Long countAdminMenuGrants(@Param("userId") Long userId, @Param("companyId") Long companyId);
|
||||
|
||||
/**
|
||||
* 该账号是否有「15 分钟内仍在跑」的任务行——供已过期但签名有效的令牌的容忍判定。
|
||||
*
|
||||
* <p>只读、走 {@code timeout="2"}:读失败或超时由调用方按「没有在跑」处理(fail-closed),
|
||||
* 绝不因为这条查询而放行。清单口径见 {@code AdminUserLiveWorkSqlTest}。</p>
|
||||
*
|
||||
* @param userId 令牌 subject 解析出的用户 id
|
||||
* @param deviceId 令牌 claim 里的 deviceId;为空则只按 user_id 匹配
|
||||
* @return 三张在跑表里新鲜运行的行数合计
|
||||
*/
|
||||
int countLiveWorkFor(@Param("userId") Long userId, @Param("deviceId") String deviceId);
|
||||
}
|
||||
|
||||
@@ -19,4 +19,22 @@
|
||||
WHERE role = 'company_super_admin'
|
||||
AND company_id = #{companyId}
|
||||
</select>
|
||||
|
||||
<!-- 会话容忍的「在跑」判定。三段标量子查询相加,不用 UNION:UNION 会把不同列级排序规则混在
|
||||
一起报 ERROR 1271(本项目踩过);标量子查询各自独立,也不存在「一行里多个独立聚合跨行借位」。
|
||||
每段都必须带 updated_at 的 15 分钟新鲜度界:少一段就是那张表永久持证。 -->
|
||||
<select id="countLiveWorkFor" resultType="int" timeout="2">
|
||||
SELECT
|
||||
(SELECT COUNT(1) FROM biz_file_task
|
||||
WHERE status = 'RUNNING' AND updated_at >= NOW() - INTERVAL 15 MINUTE
|
||||
AND (user_id = #{userId}
|
||||
<if test="deviceId != null and deviceId != ''">OR device_id = #{deviceId}</if>))
|
||||
+ (SELECT COUNT(1) FROM brand_crawl_tasks
|
||||
WHERE status = 'running' AND updated_at >= NOW() - INTERVAL 15 MINUTE
|
||||
AND user_id = #{userId})
|
||||
+ (SELECT COUNT(1) FROM biz_price_track_loop_run
|
||||
WHERE status = 'RUNNING' AND updated_at >= NOW() - INTERVAL 15 MINUTE
|
||||
AND user_id = #{userId})
|
||||
</select>
|
||||
|
||||
</mapper>
|
||||
|
||||
+94
@@ -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 备份表(备份表不参与判定,故不出现在上面)。
|
||||
*/
|
||||
}
|
||||
Reference in New Issue
Block a user