后端(四面9分批次): 版本地板自述并排 ASCII 巡检标签,锁跳过 javadoc 计数改回实测值
- ClientVersionGuardFilter 4 条中文自述旁并排 [client-version-floor]:中文签名在容器日志 换编码后整条 grep 失效,巡检只认 ASCII;判定逻辑与响应体一字未改 - ClientVersionFloorConfigTest 加第 10 例:逐行钉"带中文自述必须并排 ASCII 标签", 并含"内存里摘掉一处就掉数"的非零对照(mvn 实跑 tests=10 failures=0 errors=0) - LockSkipWitness javadoc 的 27 处/12 文件是旧数,按本轮实扫改成 28 处/11 个文件
This commit is contained in:
@@ -17,7 +17,7 @@ import java.util.concurrent.atomic.AtomicLong;
|
||||
/**
|
||||
* 分布式锁「没拿到就跳过」的可聚合出口(2026-10-09 评审「稳定 5.5」项)。
|
||||
*
|
||||
* <p>此前 {@code if (lockHandle == null) { continue; }} 在全树有 <b>27</b> 处(12 个文件),
|
||||
* <p>此前 {@code if (lockHandle == null) { continue; }} 在全树有 <b>28</b> 处(11 个文件),
|
||||
* 一处日志都不留。表现是:巡检任务每轮都跑、锁竞争越激烈被跳过的任务越多,而现网看不出任何痕迹
|
||||
* ——卡死任务没被收尾、结果作业没被续跑,日志里连一行都没有,只能靠人肉反推。跟
|
||||
* {@code TaskFileJobPublisher} 的 MQ 降级是同一个病:那条已经补了 {@code task.file.job.mq.degraded}
|
||||
|
||||
@@ -128,17 +128,17 @@ public class ClientVersionGuardFilter extends OncePerRequestFilter {
|
||||
@PostConstruct
|
||||
void reportFloorState() {
|
||||
if (!isConfigured()) {
|
||||
log.warn("[版本地板] 启动自检:min-supported-version 未配置 ⇒ 闸门惰性,逐请求跳过,"
|
||||
log.warn("[client-version-floor] [版本地板] 启动自检:min-supported-version 未配置 ⇒ 闸门惰性,逐请求跳过,"
|
||||
+ "现网装机版本分布没有任何记账数据(enforce={} rejectUnreported={})",
|
||||
enforce, rejectUnreported);
|
||||
return;
|
||||
}
|
||||
if (parse(minSupportedVersion) == null) {
|
||||
log.warn("[版本地板] 启动自检:min-supported-version=\"{}\" 解析不出数字段 ⇒ 全部上报按 "
|
||||
log.warn("[client-version-floor] [版本地板] 启动自检:min-supported-version=\"{}\" 解析不出数字段 ⇒ 全部上报按 "
|
||||
+ "unparsable 记账、永不拒绝,请把配置改回点分数字版本", minSupportedVersion);
|
||||
return;
|
||||
}
|
||||
log.info("[版本地板] 启动自检:最低支持版本={} enforce={}({})rejectUnreported={}",
|
||||
log.info("[client-version-floor] [版本地板] 启动自检:最低支持版本={} enforce={}({})rejectUnreported={}",
|
||||
minSupportedVersion.trim(), enforce,
|
||||
enforce ? "真拒绝:低于地板的装机会被挡在业务之前" : "记账模式:只计数与打日志,业务响应不变",
|
||||
rejectUnreported);
|
||||
@@ -163,7 +163,7 @@ public class ClientVersionGuardFilter extends OncePerRequestFilter {
|
||||
if (firstWitness(verdict, reported)) {
|
||||
// 一次配置变更会被每个在跑的客户端逐请求命中:这里按 (verdict, version) 去重,
|
||||
// 量交给指标,日志只留第一条(与 10-06 通知放大的处置同一口径)。
|
||||
log.warn("[版本地板] {} {} 自报版本={} 最低支持={} verdict={} enforce={} —— {}",
|
||||
log.warn("[client-version-floor] [版本地板] {} {} 自报版本={} 最低支持={} verdict={} enforce={} —— {}",
|
||||
request.getMethod(), uri, reported, minSupportedVersion.trim(), verdict, enforce,
|
||||
enforce ? "本次已拒绝" : "记账模式,暂不拒绝");
|
||||
}
|
||||
|
||||
@@ -5,6 +5,7 @@ import static org.assertj.core.api.Assertions.assertThat;
|
||||
import ch.qos.logback.classic.Logger;
|
||||
import ch.qos.logback.classic.spi.ILoggingEvent;
|
||||
import ch.qos.logback.core.read.ListAppender;
|
||||
import com.nanri.aiimage.testutil.SourceScan;
|
||||
import io.micrometer.core.instrument.Counter;
|
||||
import io.micrometer.core.instrument.simple.SimpleMeterRegistry;
|
||||
import java.io.InputStream;
|
||||
@@ -238,6 +239,40 @@ class ClientVersionFloorConfigTest {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 巡检锚点必须是 ASCII:日志级别再对、写得再清楚,容器日志换了编码之后 grep 抓不到就等于没上线。
|
||||
* 所以每条中文自述旁边都并排一条 {@code [client-version-floor]},这条判据钉的是"并排"这件事本身
|
||||
* ——摘掉任意一处都要红,而不是只数一遍总数(总数会被注释喂,故先剥注释)。
|
||||
*/
|
||||
@Test
|
||||
void everyFloorLogCarriesTheAsciiPatrolTag() {
|
||||
String body = SourceScan.withoutComments(SourceScan.sourceText("ClientVersionGuardFilter.java"));
|
||||
int cnTag = countIn(body, "[版本地板]");
|
||||
int asciiTag = countIn(body, "[client-version-floor]");
|
||||
assertThat(cnTag).as("剥掉注释后含中文自述标签的 log 语句数,改动措辞或搬文件都会让这里不等于 4").isEqualTo(4);
|
||||
assertThat(asciiTag).as("ASCII 巡检标签条数必须与中文标签一致").isEqualTo(cnTag);
|
||||
for (String line : body.split("\n")) {
|
||||
if (line.contains("[版本地板]")) {
|
||||
assertThat(line).as("这一行只带了中文标签,巡检那条 grep 就抓不到它")
|
||||
.contains("[client-version-floor]");
|
||||
}
|
||||
}
|
||||
// 非零对照:在内存里摘掉一处 ASCII 标签,上面"条数一致"必须不再成立
|
||||
String cut = body.replaceFirst(Pattern.quote("[client-version-floor] "), "");
|
||||
assertThat(countIn(cut, "[client-version-floor]")).as("摘掉一处后计数应变成 3,否则这条判据是恒真的")
|
||||
.isEqualTo(cnTag - 1);
|
||||
}
|
||||
|
||||
private static int countIn(String text, String needle) {
|
||||
int at = 0;
|
||||
int hits = 0;
|
||||
while ((at = text.indexOf(needle, at)) >= 0) {
|
||||
hits++;
|
||||
at += needle.length();
|
||||
}
|
||||
return hits;
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------- 助手
|
||||
|
||||
private ClientVersionGuardFilter filter(String minVersion, boolean enforce, boolean rejectUnreported,
|
||||
|
||||
Reference in New Issue
Block a user