fix(workbench-client): 上传强校验纯数字版本并归一化存量 v 前缀

客户端按 x.y.z 逐段比较,v1.0.112 会被严格解析器判非法,检查更新永远回「已是最新」。
- presign/confirm 只接受 ^\d+\.\d+\.\d+$,带 v 前缀、两段或后缀直接拒绝
- V178 剥离存量 v/V 前缀,冲突时中止迁移
- 后管上传表单同步校验并提示格式
This commit is contained in:
2026-10-26 15:13:36 +08:00
parent 9e5529ef59
commit 2163c6b585
7 changed files with 90 additions and 8 deletions
@@ -52,6 +52,12 @@ public class WorkbenchClientPackageService {
/** 版本号长度上限,与 biz_workbench_client_package.version VARCHAR(64) 对齐。 */
private static final int MAX_VERSION_LENGTH = 64;
/**
* 发布版本号必须是不带前缀的纯数字 x.y.z:客户端按数字逐段比较,
* "v1.0.112" / "1.0.112-beta" 会让严格解析器判为非法或比较失效。
*/
private static final Pattern VERSION_PATTERN = Pattern.compile("\\d+\\.\\d+\\.\\d+");
/** 直传预签名默认有效期:90MB 级包在慢公网入口上传时,3 分钟窗口会在途过期。 */
private static final int DEFAULT_PRESIGN_EXPIRY_SECONDS = 3600;
@@ -486,6 +492,9 @@ public class WorkbenchClientPackageService {
if (normalized.length() > MAX_VERSION_LENGTH) {
throw new BusinessException("版本号不能超过 " + MAX_VERSION_LENGTH + " 个字符");
}
if (!VERSION_PATTERN.matcher(normalized).matches()) {
throw new BusinessException("版本号必须是纯数字 x.y.z 格式(如 1.0.112),不能带 v 前缀或其他后缀");
}
return normalized;
}
@@ -0,0 +1,45 @@
-- =============================================================
-- 迁移 V178__workbench_client_version_strip_v_prefix
--
-- 1. 变更目的:把存量「工作台客户端包」版本号里的 v/V 前缀剥掉。
-- 客户端按纯数字 x.y.z 逐段比较(见 docs/AI工作台客户端-版本更新对接文档.md 4.1),
-- "v1.0.112" 会让严格解析器判非法 ⇒ 检查更新永远回「已是最新」。
-- 2026-10-26 起上传接口已在 requireVersion 强校验纯数字 x.y.z,本迁移只清存量。
--
-- 2. 口径:
-- - 只剥「v/V 紧跟数字」的行(v1.0.112 → 1.0.112),其他历史格式原样保留;
-- - 先自检剥完后是否撞 uk_workbench_client_version(V176 唯一键),有冲突就抛 1048
-- 中止,由人工决定保留哪一行,迁移不静默删数据;
-- - object_key 里的 -v1.0.112.zip 不动:客户端只用 file_url 原样下载,key 不是版本判据。
--
-- 3. 影响表与数据量:biz_workbench_client_package,KB 级字典表,当前 2 行。
--
-- 4. 回滚(如需):不可逆。v 前缀已无业务意义;恢复只能人工按审计记录回填。
-- =============================================================
CREATE TEMPORARY TABLE IF NOT EXISTS `_v178_gate` (`must_be_zero` INT NOT NULL);
-- 闸门 1:剥前缀后若与既有版本撞唯一键,中止(不静默丢行)
INSERT INTO `_v178_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM (
SELECT normalized.version
FROM (
SELECT CASE WHEN version REGEXP '^[vV][0-9]' THEN SUBSTRING(version, 2) ELSE version END AS version
FROM `biz_workbench_client_package`
) normalized
GROUP BY normalized.version
HAVING COUNT(*) > 1
) duplicated;
UPDATE `biz_workbench_client_package`
SET `version` = SUBSTRING(`version`, 2)
WHERE `version` REGEXP '^[vV][0-9]';
-- 闸门 2:迁移后不允许再存在 v/V+数字开头的版本
INSERT INTO `_v178_gate`
SELECT IF(COUNT(*) = 0, 0, NULL)
FROM `biz_workbench_client_package`
WHERE `version` REGEXP '^[vV][0-9]';
DROP TEMPORARY TABLE `_v178_gate`;
@@ -144,6 +144,20 @@ class WorkbenchClientPackageServiceTest {
verifyNoInteractions(ossStorageService);
}
@Test
void rejectsVersionsOutsideNumericXyzContract() {
// 客户端按纯数字 x.y.z 解析;v 前缀/两段/后缀都会让它判成非法或不升级(2026-10-26 线上实录)
for (String bad : List.of("v1.0.112", "V1.0.112", "1.0", "1.0.112-beta", "release-x")) {
BusinessException ex = assertThrows(BusinessException.class,
() -> service().presignPackage("pkg.zip", bad), "应拒绝版本号: " + bad);
assertTrue(ex.getMessage().contains("x.y.z"), ex.getMessage());
}
assertThrows(BusinessException.class,
() -> service().confirmPackage(PREFIX + "20261024100000123-v1.0.112.zip",
"ShuFuAI-Workbench-v1.0.112.zip", "v1.0.112"));
verifyNoInteractions(ossStorageService);
}
@Test
void confirmRecomputesSha256BeforeInsert() {
String objectKey = PREFIX + "20261024100000123-1.2.3.zip";