fix(文案出口): 用户可见提示语一律走 UserMessages 把关,并补结果作业租约围栏

两件事同源:2026-10-09 任务 30456 的卡片上同时出现中文进度和一句英文异常原文。

围栏:派发链在执行前重读 job 行,让 activateRunningClaim 的 CAS 恒真,撞锁方
deferRunning 把在跑的行翻回 PENDING,markSuccess 静默写 0 行——成功被判成失败。
claim 快照现在贯穿到 runClaimed 不再回读,markSuccess 返回布尔并补 stage=SUCCESS_LOST
日志,让这次丢失可观测。

文案:普查数出 61 处把 ex.getMessage() 拼进用户可见字段(异常响应、任务 error_message、
结果作业 error_msg、看板 message),逐条翻译追不上新增速度,改为出口把关——
UserMessages.with(中文主干, 异常) 只拼接中文详情、orFallback(原文, 兜底句) 只放行含中文的串,
被换掉的原文进日志;GlobalExceptionHandler 按码分档兜底(401/4011/40902 各说各的话)。
另把 chunk-read-failed[N] 摘要写成"第 N 分片读取失败"、TASK_LOCK_BUSY 换成中文(40902 码不动,
客户端按码分支)。数字人两处与结果作业 worker 故意仍存原文:孤儿判定与三条 preserves raw
用例按 error_message 读它,界面侧由前端 userNotice 兜住,已在新尺子里点名豁免并反查豁免是否还被用到。

尺子:RawExceptionMessageSinkGuardTest(出口行数下限硬钉 1500+内存造违例自证)、UserMessagesTest、
UserFacingMessageChineseGuardTest 豁免表收到只剩 JSON 键 msg 一条。mvn -o test 4205 例 0 失败。
This commit is contained in:
2026-10-09 19:34:25 +08:00
parent 6325a63b52
commit 2a4d15b801
76 changed files with 1160 additions and 279 deletions
@@ -0,0 +1,72 @@
package com.nanri.aiimage.common.util;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* 用户可见文案把关(2026-10-09 收口)。
*
* <p>背景:任务 30456 的结果文件其实已经生成、能下载,卡片上却跟着一条
* {@code Similar ASIN result rows are empty; please retry result generation}。文案是英文不是
* 最要命的——最要命的是它是**底层异常原文**:全仓有 61 处把 {@code ex.getMessage()} 直接
* 拼进用户可见字段(异常响应、任务 error_message、结果作业 error_msg、看板 message),
* 底层抛什么用户就看什么。逐条翻译译不完,因为新的 catch 天天在加。
*
* <p>本类把"只把中文给用户看"做成出口处的代码约束:中文照原样过,非中文换成中文句子,
* 原文只进日志。诊断信息不丢——调用点本来就带着 {@code log.warn} 的堆栈。
*/
public final class UserMessages {
private static final Logger log = LoggerFactory.getLogger(UserMessages.class);
private UserMessages() {
}
/** 中文主干 + 异常详情:详情是中文才拼接,英文详情丢弃(原文进 debug 日志)。 */
public static String with(String headline, Throwable ex) {
return with(headline, ex == null ? null : ex.getMessage());
}
/** 中文主干 + 详情:详情是中文才拼接。 */
public static String with(String headline, String detail) {
String head = headline == null ? "" : headline.trim().replaceAll("[::]\\s*$", "");
if (detail == null || detail.isBlank()) {
return head;
}
if (hasChinese(detail)) {
return head + ":" + detail.trim();
}
log.debug("[user-message] dropped non-chinese detail headline={} detail={}", head, detail);
return head;
}
/**
* 整句把关:原文含中文则照原样返回,否则返回中文兜底句。
*
* <p>用于"整条消息都来自底层"的出口({@code ApiResponse.fail(ex.getMessage())}、
* {@code setErrorMessage(ex.getMessage())})。被换掉时原文进 WARN,因为这类出口
* 调用点未必另外记日志,静默替换会把根因从系统里彻底抹掉。
*/
public static String orFallback(String raw, String fallback) {
if (raw != null && !raw.isBlank() && hasChinese(raw)) {
return raw.trim();
}
log.warn("[user-message] replaced non-chinese message fallback={} raw={}",
fallback, raw == null ? "" : raw);
return fallback;
}
/** 是否含汉字:含则认为是给人看的中文文案,可以原样透出。 */
public static boolean hasChinese(String text) {
if (text == null) {
return false;
}
for (int i = 0; i < text.length(); i++) {
char c = text.charAt(i);
if (c >= '一' && c <= '鿿') {
return true;
}
}
return false;
}
}