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
@@ -1,5 +1,6 @@
package com.nanri.aiimage.modules.split.service;
import com.nanri.aiimage.common.util.UserMessages;
import cn.hutool.core.io.FileUtil;
import cn.hutool.core.util.IdUtil;
import cn.hutool.json.JSONUtil;
@@ -81,7 +82,7 @@ public class SplitRunService {
try {
File inputFile = findLocalSourceFile(sourceFile.getFileKey());
if (inputFile == null || !inputFile.exists()) {
throw new BusinessException("Uploaded source file does not exist, please upload again.");
throw new BusinessException("上传的源文件不存在,请重新上传。");
}
String inputName = sourceFile.getOriginalFilename() == null
@@ -97,7 +98,7 @@ public class SplitRunService {
SplitResultItemVo item = new SplitResultItemVo();
item.setSourceFilename(sourceFile.getOriginalFilename());
item.setSuccess(false);
item.setError(ex.getMessage());
item.setError(UserMessages.orFallback(ex.getMessage(), "这个文件拆分失败,请检查内容后重新上传"));
item.setEntries(new ArrayList<>());
item.setEntryCount(0);
items.add(item);
@@ -108,7 +109,7 @@ public class SplitRunService {
resultEntity.setModuleType(MODULE_TYPE);
resultEntity.setSourceFilename(sourceFile.getOriginalFilename());
resultEntity.setSuccess(0);
resultEntity.setErrorMessage(ex.getMessage());
resultEntity.setErrorMessage(UserMessages.orFallback(ex.getMessage(), "这个文件拆分失败,请检查内容后重新上传"));
resultEntity.setUserId(request.getUserId());
resultEntity.setCreatedAt(LocalDateTime.now());
fileResultMapper.insert(resultEntity);
@@ -224,7 +225,7 @@ public class SplitRunService {
public void deleteHistory(Long resultId, Long userId) {
FileResultEntity entity = fileResultMapper.selectById(resultId);
if (entity == null || !MODULE_TYPE.equals(entity.getModuleType()) || !userId.equals(entity.getUserId())) {
throw new BusinessException("Split result record does not exist.");
throw new BusinessException("没有这条拆分结果。");
}
fileResultMapper.deleteById(resultId);
}
@@ -232,7 +233,7 @@ public class SplitRunService {
public String getResultDownloadUrl(Long resultId, Long userId) {
FileResultEntity entity = fileResultMapper.selectById(resultId);
if (entity == null || entity.getResultFileUrl() == null || !MODULE_TYPE.equals(entity.getModuleType()) || !userId.equals(entity.getUserId())) {
throw new BusinessException("Split result file does not exist.");
throw new BusinessException("拆分结果文件不存在。");
}
return ossStorageService.generateFreshDownloadUrl(entity.getResultFileUrl());
}
@@ -244,7 +245,7 @@ public class SplitRunService {
) throws Exception {
CountResult countResult = countSplitRows(inputFile, request.getSelectedColumns());
if (countResult.rowCount() <= 0) {
throw new BusinessException("No data rows available for splitting.");
throw new BusinessException("没有可拆分的数据行。");
}
List<Integer> chunkSizes = buildChunkSizes(countResult.rowCount(), request);
@@ -270,7 +271,7 @@ public class SplitRunService {
.filter(column -> !resolvedHeaderMap.containsKey(column))
.toList();
if (!missing.isEmpty()) {
throw new BusinessException("Missing required columns: " + String.join(", ", missing));
throw new BusinessException("缺少必需列: " + String.join(", ", missing));
}
headerMapHolder.set(resolvedHeaderMap);
}
@@ -282,7 +283,7 @@ public class SplitRunService {
}
Map<String, Integer> resolvedHeaderMap = headerMapHolder.get();
if (resolvedHeaderMap == null) {
throw new BusinessException("Excel header row is empty.");
throw new BusinessException("Excel 表头行为空。");
}
List<String> projected = new ArrayList<>();
for (String column : request.getSelectedColumns()) {
@@ -327,7 +328,7 @@ public class SplitRunService {
.filter(column -> !resolvedHeaderMap.containsKey(column))
.toList();
if (!missing.isEmpty()) {
throw new BusinessException("Missing required columns: " + String.join(", ", missing));
throw new BusinessException("缺少必需列: " + String.join(", ", missing));
}
sheetName[0] = currentSheetName == null || currentSheetName.isBlank() ? "Sheet1" : currentSheetName;
headerRead[0] = true;
@@ -336,13 +337,13 @@ public class SplitRunService {
@Override
public void onRow(String currentSheetName, Integer sheetNo, int rowIndex, Map<Integer, String> headerMap, Map<Integer, String> rowMap) {
if (!headerRead[0]) {
throw new BusinessException("Excel header row is empty.");
throw new BusinessException("Excel 表头行为空。");
}
rowCount[0]++;
}
});
if (!headerRead[0]) {
throw new BusinessException("Excel header row is empty.");
throw new BusinessException("Excel 表头行为空。");
}
return new CountResult(rowCount[0], sheetName[0]);
}
@@ -384,15 +385,15 @@ public class SplitRunService {
private void validateRequest(SplitRunRequest request) {
if (!List.of(SPLIT_MODE_ROWS_PER_FILE, SPLIT_MODE_PARTS).contains(request.getSplitMode())) {
throw new BusinessException("Invalid split mode.");
throw new BusinessException("拆分方式不合法。");
}
if (SPLIT_MODE_ROWS_PER_FILE.equals(request.getSplitMode())
&& (request.getRowsPerFile() == null || request.getRowsPerFile() <= 0)) {
throw new BusinessException("Invalid rowsPerFile value.");
throw new BusinessException("每个文件行数不合法。");
}
if (SPLIT_MODE_PARTS.equals(request.getSplitMode())
&& (request.getParts() == null || request.getParts() <= 0)) {
throw new BusinessException("Invalid parts value.");
throw new BusinessException("拆分份数不合法。");
}
}
@@ -446,7 +447,7 @@ public class SplitRunService {
zos.closeEntry();
}
} catch (Exception ex) {
throw new BusinessException("拆分结果打包失败:" + ex.getMessage());
throw new BusinessException(UserMessages.with("拆分结果打包失败", ex));
}
return zipFile;
}