diff --git a/community-adminapi/src/test/java/com/linkerbot/community/adminapi/AdminWorkflowTest.java b/community-adminapi/src/test/java/com/linkerbot/community/adminapi/AdminWorkflowTest.java index f900a34..fae542a 100644 --- a/community-adminapi/src/test/java/com/linkerbot/community/adminapi/AdminWorkflowTest.java +++ b/community-adminapi/src/test/java/com/linkerbot/community/adminapi/AdminWorkflowTest.java @@ -633,10 +633,16 @@ class AdminWorkflowTest { JsonNode blocked = request(signed(get("/admin-api/project-imports/" + code)), 200).path("data"); assertThat(blocked.path("status").asText()).isEqualTo("REVIEW"); assertThat(blocked.path("errorCode").asText()).isEqualTo("CLEANUP_REPOSITORY_UNSAFE"); - assertThat(blocked.path("canRetry").asBoolean()).isFalse(); + assertThat(blocked.path("canRetry").asBoolean()).isTrue(); + assertThat(blocked.path("retryMessage").asText()).contains("手工删除"); assertThat(gitea.deletions).isZero(); assertThat(gitea.migrations).isEqualTo(1); assertThat(gitea.inspect(repoName)).isNotNull(); + // 再次点击只能触发重新核验,不能绕过归属校验去删除仍存在的仓库。 + request(signed(post("/admin-api/project-imports/" + code + "/retry")), 202); + imports.run(code); + assertThat(gitea.deletions).isZero(); + assertThat(gitea.migrations).isEqualTo(1); } @Test @@ -654,11 +660,60 @@ class AdminWorkflowTest { imports.run(code); JsonNode blocked = request(signed(get("/admin-api/project-imports/" + code)), 200).path("data"); assertThat(blocked.path("errorCode").asText()).isEqualTo("CLEANUP_REPOSITORY_REPLACED"); - assertThat(blocked.path("canRetry").asBoolean()).isFalse(); + assertThat(blocked.path("canRetry").asBoolean()).isTrue(); assertThat(gitea.deletions).isZero(); assertThat(gitea.migrations).isEqualTo(before); } + @Test + void manuallyRemovedUnsafeRepositoryCanRetryWithoutEditingTaskState() throws Exception { + JsonNode task = createImport(); + String code = task.path("taskCode").asText(); + String repoName = "p_" + task.path("projectCode").asText(); + gitea.migrationRejected = true; + imports.run(code); + gitea.migrationDescriptions.remove(repoName); // 旧任务的残留仓库没有任务标识。 + request(signed(post("/admin-api/project-imports/" + code + "/retry")), 202); + imports.run(code); + assertThat(request(signed(get("/admin-api/project-imports/" + code)), 200) + .path("data").path("errorCode").asText()).isEqualTo("CLEANUP_REPOSITORY_UNSAFE"); + gitea.deleteRepository(gitea.inspect(repoName).repository()); // 模拟管理员手工删除。 + JsonNode refreshed = request(signed(get("/admin-api/project-imports/" + code)), 200).path("data"); + assertThat(refreshed.path("canRetry").asBoolean()).isTrue(); + assertThat(refreshed.path("status").asText()).isEqualTo("REVIEW"); + gitea.migrationRejected = false; + request(signed(post("/admin-api/project-imports/" + code + "/retry")), 202); + imports.run(code); + JsonNode done = request(signed(get("/admin-api/project-imports/" + code)), 200).path("data"); + assertThat(done.path("status").asText()).isEqualTo("SUCCEEDED"); + assertThat(done.path("projectCode")).isEqualTo(task.path("projectCode")); + assertThat(gitea.deletions).isEqualTo(1); // 后台没有额外删除任何仓库。 + assertThat(gitea.migrations).isEqualTo(2); + } + + @Test + void manuallyRemovedReplacementCanRetryWithRecordedOldRepositoryIdentity() throws Exception { + JsonNode task = createImport(); + String code = task.path("taskCode").asText(); + String name = "p_" + task.path("projectCode").asText(); + gitea.migrationRejected = true; + imports.run(code); + gitea.migrationRejected = false; + gitea.migrate("https://github.com/example/robot.git", name, java.time.Duration.ofSeconds(1), + "community-import:" + code); + request(signed(post("/admin-api/project-imports/" + code + "/retry")), 202); + imports.run(code); + assertThat(request(signed(get("/admin-api/project-imports/" + code)), 200) + .path("data").path("errorCode").asText()).isEqualTo("CLEANUP_REPOSITORY_REPLACED"); + gitea.deleteRepository(gitea.inspect(name).repository()); + request(signed(post("/admin-api/project-imports/" + code + "/retry")), 202); + imports.run(code); + assertThat(request(signed(get("/admin-api/project-imports/" + code)), 200) + .path("data").path("status").asText()).isEqualTo("SUCCEEDED"); + assertThat(gitea.deletions).isEqualTo(1); + assertThat(gitea.migrations).isEqualTo(3); + } + @Test void cleanupTimeoutCanResumeAfterConfirmingDeletionWithoutDeletingAgain() throws Exception { JsonNode task = createImport(); diff --git a/community-service/src/main/java/com/linkerbot/community/service/admin/AdminImportService.java b/community-service/src/main/java/com/linkerbot/community/service/admin/AdminImportService.java index e967bc0..bd3aba3 100644 --- a/community-service/src/main/java/com/linkerbot/community/service/admin/AdminImportService.java +++ b/community-service/src/main/java/com/linkerbot/community/service/admin/AdminImportService.java @@ -318,9 +318,9 @@ public class AdminImportService { if (task.getReceiptJson() != null) return false; if ("MIGRATING".equals(task.getPhase())) return "GITEA_MIGRATION_REJECTED".equals(task.getErrorCode()); - return "CLEANING".equals(task.getPhase()) - && !Set.of("CLEANUP_REPOSITORY_UNSAFE", "CLEANUP_REPOSITORY_REPLACED", "SOURCE_CHANGED") - .contains(task.getErrorCode() == null ? "" : task.getErrorCode()); + // 人工清理后仍使用原入口重新核验。是否可删除由后台的仓库归属检查决定, + // 不因错误码被清除或用户再次点击而绕过;来源身份已变化则继续阻断。 + return "CLEANING".equals(task.getPhase()) && !"SOURCE_CHANGED".equals(task.getErrorCode()); } private boolean canRetry(ProjectImportTask task) { @@ -347,6 +347,10 @@ public class AdminImportService { private String retryMessage(ProjectImportTask task, boolean retry) { if (!Set.of("FAILED", "REVIEW").contains(task.getStatus())) return null; if (!retry) return "当前项目状态或远端结果不允许安全重试,需要维护人员核对"; + if ("CLEANING".equals(task.getPhase()) + && Set.of("CLEANUP_REPOSITORY_UNSAFE", "CLEANUP_REPOSITORY_REPLACED") + .contains(task.getErrorCode() == null ? "" : task.getErrorCode())) + return "残留仓库身份核验未通过;若已手工删除目标仓库,可重试核验并继续迁移,保留项目资料、封面和 URDF"; if (recreateOnRetry(task)) return "将核验并清理本任务的失败仓库后重新迁移,保留项目资料、封面和 URDF"; if (task.getReceiptJson() != null) return "将核验已迁移的仓库并继续后续步骤,不会删除仓库"; diff --git a/docs/admin-api.md b/docs/admin-api.md index a0e5303..403c502 100644 --- a/docs/admin-api.md +++ b/docs/admin-api.md @@ -1037,7 +1037,7 @@ async function watchImport( - 已取得成功迁移收据时,重试只核验并继续后续步骤,不删除已迁移仓库。项目已 READY、发布过、下架或删除时拒绝重试。 - 超时、进程在远端迁移期间中断等未知结果,不自动删除仓库或重发迁移;canRetry=false 时由维护人员处理。清理本身超时或回写中断,可通过重试重新核验目标是否已删除后恢复。 - 旧版本显示 REVIEW 且错误为 GITEA_MIGRATION_REJECTED 的任务,也可以显示重试按钮。若仓库已不存在可以重迁;若仍有残留,但缺少新版本的任务归属标识,则停止清理并返回 REVIEW,避免误删。 -- 如果返回 CLEANUP_REPOSITORY_UNSAFE 或 CLEANUP_REPOSITORY_REPLACED,说明仓库归属无法核实或身份变化,未删除仓库,canRetry=false,提示联系维护人员。 +- 如果返回 CLEANUP_REPOSITORY_UNSAFE 或 CLEANUP_REPOSITORY_REPLACED,说明残留仓库归属无法核实或身份变化,未删除仓库。项目仍允许恢复时 canRetry=true,retryMessage 提示先人工核对清理;人工删除目标仓库后,刷新并点击同一“重试迁移”按钮即可,无需修改数据库或新建任务。重试仍先核验:仓库依然存在且无法确认归属时继续阻断,确认不存在才重新迁移。canRetry=true 表示允许再次核验,不表示仓库已清理或必然迁移成功。 - 重复来源可能返回 409 `DUPLICATE_SOURCE`,错误 data 中的 projectCode 可用于跳转现有项目。不要改项目名或重新预检后循环创建。 - 没有取消任务、强行成功、任意删除仓库、定期同步源仓库的接口;失败仓库清理只能通过上述受保护的 retry 流程执行。 - 迁移保留 Git 历史、分支、标签并迁移 LFS;不迁移 Issue、PR、Wiki、Release 附件,不递归复制子模块依赖。保留分支不代表后台可切换分支。 diff --git a/docs/admin-deployment.md b/docs/admin-deployment.md index a32d394..14e3f21 100644 --- a/docs/admin-deployment.md +++ b/docs/admin-deployment.md @@ -62,6 +62,7 @@ project 表只新增 moderation_reason 和 repo_write_status,来源标识、 - 超时、进程在 MIGRATING 阶段中断或远端结果不明确时进入 REVIEW。禁止自动重发,也不能仅凭仓库存在判定成功。 - Gitea 明确返回 GITEA_MIGRATION_REJECTED 时显示 FAILED,提供重试。原有同错误的 REVIEW 任务也可申请重试;后台持有项目共享锁,在 CLEANING 阶段核验任务标识、组织、名称、来源及已记录的仓库 ID,清理后确认不存在再迁移。没有残留仓库时直接继续,不删除项目记录或 OSS 资源。 - 清理操作写入前持久化 CLEANING 阶段及仓库身份;删除超时或数据库回写失败时保持阻断,下次重试先核验是否已删除再继续。仓库已替换、来源不符、缺少任务归属标识时不删除;旧任务的无标识残留仓库仍需人工核对。已就绪、发布过的项目及已有成功收据的迁移不会走删除重迁流程。 +- 人工核对后已删除目标仓库的任务,可在原任务页刷新并重试,无需修改状态或清空仓库 ID。后台重新确认仓库不存在后才清除旧仓库关联和写入阻断,保留原项目与资源继续迁移;再次点击不能绕过仍存在仓库的身份校验。 - REMOTE_RESULT_UNKNOWN 需要按 requestId、项目编码、任务编码核对日志和 Gitea,不应删除目标仓库后直接重跑。 - 已持久化成功收据且停在 MIGRATED 的任务,retry 会只读验证仓库身份、来源等后续跑。 - 停在 NORMALIZING/BRANCH_READY 且有冻结目标 SHA 的任务,retry 会核对已适配分支和收据后续跑;验证不通过继续阻断。