fix(phase-5.1): 回收/确认幂等与两前端分片重试按 CR 消项加固

- 分片回收与 savePart/complete 共用会话锁并锁内复查 mtime
- 版本/教程 confirm 按 version 或 fileName+version 幂等返回既有行
- 证据登记失败补偿删除已上传对象;标签截断到列宽 32
- 用户端分片持久化 upload_id、校验包体失败、失败不再 DELETE
- 后管逐片重试 2 次、放弃时删除会话;catch 台账抬到 1057/190
This commit is contained in:
2026-10-31 04:26:58 +08:00
parent b13d795731
commit 2c2cb23943
7 changed files with 187 additions and 44 deletions
@@ -70,7 +70,20 @@ public class TaskEvidenceService {
entity.setContentType(stored.contentType());
entity.setSha256(stored.sha256());
entity.setCreatedAt(LocalDateTime.now());
mapper.insert(entity);
try {
mapper.insert(entity);
} catch (RuntimeException ex) {
// 对象已写进桶、登记行没落:不回收就是永久孤儿(保留期只扫登记行)。
log.warn("[task-evidence] 登记行写入失败,回收对象 taskId={} key={} reason={}",
normalizedTaskId, stored.objectKey(), ex.getMessage());
try {
storage.delete(stored.objectKey());
} catch (RuntimeException cleanup) {
log.warn("[task-evidence] 回收孤儿对象失败 key={} reason={}",
stored.objectKey(), cleanup.getMessage());
}
throw new BusinessException("证据件登记失败,请稍后重试");
}
deleteTempQuietly(file);
Map<String, Object> result = new LinkedHashMap<>();
result.put("id", entity.getId());
@@ -194,7 +207,8 @@ public class TaskEvidenceService {
if (text.isEmpty()) {
return fallback;
}
return text.length() > 64 ? text.substring(0, 64) : text;
// 列宽是 VARCHAR(32),超长标签在这里截断而不是让 insert 抛数据截断错。
return text.length() > 32 ? text.substring(0, 32) : text;
}
private void deleteTempQuietly(File file) {
@@ -298,13 +298,25 @@ public class ChunkedUploadService {
long cutoff = System.currentTimeMillis() - Math.max(1, staleHours) * 3600_000L;
try (Stream<Path> children = Files.list(root)) {
children.forEach(child -> {
try {
if (Files.getLastModifiedTime(child).toMillis() < cutoff) {
deleteQuietly(child);
log.info("[chunk-upload] 清理过期分片会话/残留文件 path={}", child.getFileName());
String name = child.getFileName().toString();
Runnable sweep = () -> {
try {
// 复查一次 mtime:等锁期间刚被 savePart 刷新的会话不能删。
if (Files.getLastModifiedTime(child).toMillis() < cutoff) {
deleteQuietly(child);
log.info("[chunk-upload] 清理过期分片会话/残留文件 path={}", child.getFileName());
}
} catch (IOException ex) {
log.warn("[chunk-upload] 条目时间戳读不出,本轮跳过该条 path={}", child.getFileName());
}
} catch (IOException ex) {
log.warn("[chunk-upload] 条目时间戳读不出,本轮跳过该条 path={}", child.getFileName());
};
if (UPLOAD_ID_PATTERN.matcher(name).matches()) {
// 与 savePart/complete 共用会话锁:在飞上传不会被整点回收腰斩。
synchronized (lockOf(name)) {
sweep.run();
}
} else {
sweep.run();
}
});
} catch (IOException ex) {
@@ -272,6 +272,15 @@ public class SoftwareVersionService {
if (size > MAX_UPLOAD_BYTES) {
throw new BusinessException("文件超过允许的大小限制");
}
// 同一 version 已登记(超时重试/双击):直接返回既有行,临时件删掉即可。
SoftwareVersionEntity existing = softwareVersionMapper.selectOne(
new LambdaQueryWrapper<SoftwareVersionEntity>()
.eq(SoftwareVersionEntity::getVersion, normalizedVersion)
.last("LIMIT 1"));
if (existing != null) {
deleteTempQuietly(source);
return toItemMap(existing);
}
String objectKey = softwareVersionObjectKey(normalizedVersion);
String fileUrl = ossStorageService.uploadSoftwareVersionPackage(source, objectKey);
SoftwareVersionEntity entity = new SoftwareVersionEntity();
@@ -148,6 +148,18 @@ public class TutorialPackageService {
if (size > MAX_UPLOAD_BYTES) {
throw new BusinessException("文件超过允许的大小限制");
}
// 同一 fileName+version 已登记(超时重试/双击):返回既有行,不重复搬桶。
TutorialPackageEntity existing = tutorialPackageMapper.selectOne(
new LambdaQueryWrapper<TutorialPackageEntity>()
.eq(TutorialPackageEntity::getFileName, normalizedName)
.eq(TutorialPackageEntity::getVersion, normalizedVersion)
.last("LIMIT 1"));
if (existing != null) {
if (source.exists() && !source.delete()) {
log.warn("[tutorial] 清理重复提交的临时件失败 path={}", source.getAbsolutePath());
}
return toItemMap(existing);
}
String generatedKey = OBJECT_KEY_PREFIX + OBJECT_NAME_FORMATTER.format(LocalDateTime.now())
+ "-" + safeFileName(normalizedName);
ossStorageService.uploadTutorialPackage(source, generatedKey);
@@ -61,7 +61,8 @@ class CatchSilenceRatchetTest {
// 逐处记名见 STRICT_TOTAL 上方注释;EMPTY 一格没涨)。
// 10-30 用户端代理白名单(极客/青果)抬 591 -> 598(7 处逐一记名见 STRICT_TOTAL 上方注释;
// 实测量到 599,多出的 1 格来自已提交的 79b04afd(AdminApiGuardFilter 编码绕过 catch),见同处说明)。
static final int GIVEN_NOT_RETHROW = 599;
// 10-31 Phase 5.1:证据登记失败回收对象一枚(内层回收失败只 WARN),599 -> 600。
static final int GIVEN_NOT_RETHROW = 600;
static final int GIVEN_LOG_ONLY = 249;
static final int GIVEN_EMPTY = 56;
@@ -273,8 +274,13 @@ class CatchSilenceRatchetTest {
* </ul>
* 同批实测 total 1055、rethrow 400、notRethrow 599(未涨,register 是重抛形状)、
* logOnly 189、empty 56。
*
* <p>10-31 Phase 5.1 CR 消项再抬 1055 -&gt; 1057,两枚逐处记名(都在
* {@code TaskEvidenceService.register} 的登记行写入失败兜底):外层 catch 回收已上传对象
* 后转业务错误(RETHROW+rethrow 401);内层 catch 是对象回收本身失败只 WARN
* (LOG_ONLY+logOnly 190)。两处误差方向都是「不让孤儿对象永久占桶」。
*/
static final int STRICT_TOTAL = 1055;
static final int STRICT_TOTAL = 1057;
/**
* 重抛型 catch 的**下限**(不是上限):本轮把两处吞异常改成重抛之后实测 388。
* 这一格只能涨不能跌——它是"异常会往外走"的总量,把它钉成"只许减"就等于拦着别人修吞异常。
@@ -397,7 +403,8 @@ class CatchSilenceRatchetTest {
* 复测整树 599:多出的 1 格来自已提交的 79b04afd {@code AdminApiGuardFilter.decodePath}
* (畸形编码保持原样交给容器 400),非本批新增,说明见 STRICT_TOTAL 上方。
*/
static final int STRICT_NOT_RETHROW = 599;
// 10-31 Phase 5.1:同 GIVEN_NOT_RETHROW,证据登记补偿回收失败只 WARN,599 -> 600。
static final int STRICT_NOT_RETHROW = 600;
/**
* 10-17 抬 172 -> 173,出处就是上面点名过的 {@code TaskHeartbeatLivenessService.stamp()}:
* 块体只有「取到 key 名 + log.warn」一句,写心跳证据失败时既不重试也不抛出——
@@ -428,8 +435,10 @@ class CatchSilenceRatchetTest {
* {@code WorkbenchClientPackageService.abortChunkedPackage} 的 INFO 与 WARN 两枚。
* 10-31 抬 188 -> 189:{@code TaskEvidenceService.purgeExpired} 的逐行保留期回收出口,
* 块体只有一句带 {@code [task-evidence]} 锚点的 WARN(id+reason),坏行跳过、其余照删。
* 同日 Phase 5.1 再抬 189 -> 190:登记行落库失败后的对象回收失败只 WARN(同上锚点),
* 主错误仍由外层转业务错误;不吞主错误。
*/
static final int STRICT_LOG_ONLY = 189; // 严格口径:块内每条顶层语句都是 log 调用才算
static final int STRICT_LOG_ONLY = 190; // 严格口径:块内每条顶层语句都是 log 调用才算
static final int STRICT_EMPTY = 56;
/**