Import from Git V2：常见问题与排错

1. 为什么 GitHub 账号已经连上了，但仓库列表还是空的？

因为在 V2 里，账号连接和仓库访问范围是两件事。

请检查：

• 是否选中了正确的 installation
• 目标仓库是否已经被加入 GitHub App 范围
• GitHub 侧变更后，是否已经执行 Refresh GitHub App Scope

另见：Import from Git V2：管理 GitHub 连接与仓库访问范围

2. 为什么向导里的 Next 按钮是灰的？

因为当前步骤还没有完成。

常见原因包括：

• 第 1 步：账号、installation、仓库或 runtime 还没选完整
• 第 2 步：分支或 pinned commit 还没选完整
• 第 3 步：导入根目录或文件还没选完整
• 第 4 步：一个或多个文件的必填元数据还不完整

3. 为什么 Track Latest 没有自动为新文件创建 Test Case？

因为 V2 把代码跟踪和关系变更拆开了。

如果要把新增文件纳入这条导入记录，必须在详情页里显式执行 Import Added Files。

4. 为什么源端删除文件后，没有自动删掉 Test Case？

因为 V2 不会在源文件消失时自动删除 Test Case。

您需要使用 Mark Source Deleted，把对应 binding 显式标记为 source_deleted。

5. 为什么 GitHub Webhook 的行为和我预期不一样？

Webhook 的行为取决于导入模式：

• Sync Link + Track Latest：Webhook 主要触发同步检查
• Managed Import + Track Latest：Webhook 可以推进 Mirror
• Pinned Commit：Webhook 不可用

无论哪种模式，Webhook 都不能替代 Import Added Files 或 Mark Source Deleted。

6. 为什么 Sync 按钮没有出现，或者是灰的？

常见原因包括：

• 当前是 Sync Link + Track Latest，这类记录本来就没有手动代码同步
• 当前记录固定在某个 commit 上
• 连接已经失效
• 已经有一条同步正在进行
• Mirror 已经是最新状态

7. 为什么创建之后不能改 Runtime？

这是 V2 的产品规则。

Runtime 会在创建导入记录时固定下来，因此请在第 1 步谨慎选择。

8. 删除 Import History 会发生什么？

删除一条导入记录时，系统会删除所有关联 Test Case。

如果这条记录是 Managed Import，对应的 Mirror 也会被立即删除。

9. V2 里最值得先搞懂的名词有哪些？

建议优先理解这些术语：

• GitHub App installation
• Repository Access Scope
• Sync Link
• Managed Import
• Track Latest
• Pinned Commit
• Mirror
• source_deleted

另见：术语表