JGit无Blob克隆后无法获取Blob：checkout报MissingObjectException

使用Git命令行完成无Blob克隆后，可正常拉取分支并检出指定路径，但用JGit实现相同逻辑时会抛出MissingObjectException，甚至用JGit克隆的仓库在命令行执行同样checkout操作也失败——全程用命令行操作则无此问题。

命令行可行操作示例 #

# 克隆仓库但不检出任何Blob
git clone --no-checkout --filter=blob:none <GIT-URL> .
# 拉取远程develop分支到本地
git fetch origin develop:develop
# 切换HEAD指向develop分支
git symbolic-ref HEAD refs/heads/develop
# 检出指定目录/文件
git checkout develop <DIRECTORY-OR-FILE>

原JGit报错代码 #

FilterSpec filter = FilterSpec.fromFilterLine("blob:none");
try (Git git = Git.cloneRepository()
        .setCredentialsProvider(getCredentialsProvider())
        .setDirectory(new File("/tmp/repository"))
        .setURI(<GIT-URL>)
        .setRemote(Constants.DEFAULT_REMOTE_NAME)
        .setTransportConfigCallback(t -> t.setFilterSpec(filter))
        .setNoCheckout(true)
        .call()) {
  git.fetch()
          .setCredentialsProvider(getCredentialsProvider())
          .setRemote(Constants.DEFAULT_REMOTE_NAME)
          .setRefSpecs("refs/heads/develop:refs/heads/develop")
          .call();
  git.getRepository()
          .getRefDatabase()
          .newUpdate(Constants.HEAD, false)
          .link("refs/heads/develop");
  git.checkout()
          .setName("develop")
          .addPath(<DIRECTORY-OR-FILE>)
          .call();
  ...
}

报错信息 #

org.eclipse.jgit.errors.MissingObjectException: Missing unknown 57a7e7d782f72a1e846b08415c56684f8f42e5bf

问题根源 #

1. JGit Fetch未继承克隆阶段的Filter配置：命令行Git会自动保留克隆时的--filter=blob:none规则，后续fetch操作默认遵循该配置；但JGit的FetchCommand不会自动继承克隆时的filter，导致拉取的develop分支仅包含commit和tree对象，未启用按需拉取blob的机制。
2. JGit Checkout未触发自动拉取：命令行Git在检出缺失的blob时会自动触发按需拉取，但JGit的CheckoutCommand默认不支持该行为，无法主动拉取缺失的对象。

解决方法 #

方法1：Fetch时显式设置FilterSpec

在fetch操作中添加与克隆时相同的filter配置，确保拉取的分支使用部分克隆模式：

git.fetch()
        .setCredentialsProvider(getCredentialsProvider())
        .setRemote(Constants.DEFAULT_REMOTE_NAME)
        .setRefSpecs("refs/heads/develop:refs/heads/develop")
        .setTransportConfigCallback(t -> t.setFilterSpec(filter)) // 新增：继承克隆时的filter
        .call();

方法2：手动拉取缺失的Blob对象

在执行checkout前，先遍历目标路径对应的tree对象，识别缺失的blob并手动拉取：

// 在checkout代码前添加以下逻辑
Repository repo = git.getRepository();
try (RevWalk revWalk = new RevWalk(repo)) {
  RevCommit commit = revWalk.parseCommit(repo.resolve("refs/heads/develop"));
  RevTree tree = commit.getTree();
  // 遍历目标路径对应的树节点
  try (TreeWalk treeWalk = TreeWalk.forPath(repo, <DIRECTORY-OR-FILE>, tree)) {
    if (treeWalk != null && treeWalk.getObjectId(0).getType() == Constants.OBJ_BLOB) {
      ObjectId blobId = treeWalk.getObjectId(0);
      // 检查本地是否存在该blob，不存在则从远程拉取
      if (!repo.hasObject(blobId)) {
        try (Transport transport = Transport.open(repo, Constants.DEFAULT_REMOTE_NAME)) {
          transport.setFilterSpec(filter);
          transport.fetch(null, Collections.singleton(blobId));
        }
      }
    }
  }
}

方法3：开启仓库的按需拉取配置

通过设置仓库配置，让JGit在遇到缺失对象时自动触发远程拉取，和命令行Git行为对齐：

Repository repo = git.getRepository();
repo.getConfig().setBoolean("core", null, "partialClone", true);
repo.getConfig().save();

内容的提问来源于stack exchange，提问作者maqroll