使用JGit创建InMemoryRepository遇NoWorkTreeException问题排查

我正尝试从头创建InMemoryGitRepository，最终计划采用自定义DFSRepository作为Git后端，当前先基于默认InMemoryRepository测试。已掌握将现有仓库克隆到InMemoryRepository的方法，但在从头创建仓库并添加文件时遇到阻碍。

原代码 #

private static void initInMemoryGit() throws IOException, GitAPIException {

    DfsRepositoryDescription repoDesc = new DfsRepositoryDescription("test");

    //InMemoryRepository repo = new InMemoryRepository(repoDesc);
    InMemoryRepository repo = new InMemoryRepository.Builder().setRepositoryDescription(repoDesc)
                                                              .setInitialBranch("master")
                                                              .build();
    repo.create();
    Git git = new Git(repo);
    File textFile = new File("/tmp/TestGitRepository", "test.txt");
    Files.write(textFile.toPath(), "hi".getBytes());

    git.add().addFilepattern(textFile.getName()).call();
    git.commit().setMessage("hi").call();

}

报错信息 #

Exception in thread "main" org.eclipse.jgit.errors.NoWorkTreeException: Bare Repository has neither a working tree, nor an index
    at org.eclipse.jgit.lib.Repository.getIndexFile(Repository.java:1200)
    at org.eclipse.jgit.dircache.DirCache.lock(DirCache.java:259)
    at org.eclipse.jgit.lib.Repository.lockDirCache(Repository.java:1282)
    at org.eclipse.jgit.api.AddCommand.call(AddCommand.java:122)
    at oracle.bi.versioncontrol.jgit.JGitVersionInMemory.initInMemoryGit(JGitVersionInMemory.java:114)
    at oracle.bi.versioncontrol.jgit.JGitVersionInMemory.main(JGitVersionInMemory.java:51)

我认为内存仓库无需设置索引或工作树文件，但报错信息指向该问题，请问我遗漏了什么？

解决方案 #

InMemoryRepository默认是裸仓库（Bare Repository），这类仓库没有工作区（Working Tree）和索引（Index），而git.add()命令依赖工作区文件和索引来追踪变更，所以会抛出NoWorkTreeException。

要在裸仓库中添加内容，需要直接操作Git的底层对象模型，跳过工作区和索引步骤，手动创建Blob、Tree和Commit对象：

修改后的代码示例 #

private static void initInMemoryGit() throws IOException, GitAPIException {
    DfsRepositoryDescription repoDesc = new DfsRepositoryDescription("test");
    InMemoryRepository repo = new InMemoryRepository.Builder()
            .setRepositoryDescription(repoDesc)
            .setInitialBranch("master")
            .build();
    repo.create();

    // 1. 创建Blob对象（存储文件内容）
    byte[] fileContent = "hi".getBytes();
    ObjectInserter inserter = repo.newObjectInserter();
    ObjectId blobId = inserter.insert(Constants.OBJ_BLOB, fileContent);
    inserter.flush();

    // 2. 创建Tree对象（存储文件路径与Blob的映射）
    DirCache dirCache = DirCache.newInCore();
    DirCacheEditor editor = dirCache.editor();
    editor.add(new DirCacheEditor.PathEdit("test.txt") {
        @Override
        public void apply(DirCacheEntry entry) {
            entry.setFileMode(FileMode.REGULAR_FILE);
            entry.setObjectId(blobId);
        }
    });
    editor.finish();
    ObjectId treeId = dirCache.writeTree(inserter);
    inserter.flush();

    // 3. 创建Commit对象
    PersonIdent committer = new PersonIdent("Your Name", "your.email@example.com");
    CommitBuilder commitBuilder = new CommitBuilder();
    commitBuilder.setTreeId(treeId);
    commitBuilder.setMessage("hi");
    commitBuilder.setCommitter(committer);
    commitBuilder.setAuthor(committer);
    // 初始提交无父提交，若后续提交需设置parentId
    ObjectId commitId = inserter.insert(commitBuilder);
    inserter.close();

    // 4. 更新分支引用指向新创建的Commit
    RefUpdate refUpdate = repo.updateRef(Constants.R_HEADS + "master");
    refUpdate.setNewObjectId(commitId);
    refUpdate.setForceUpdate(true);
    refUpdate.update();

    // 验证提交是否成功
    try (Git git = new Git(repo)) {
        Iterable<RevCommit> commits = git.log().all().call();
        for (RevCommit commit : commits) {
            System.out.println("Commit: " + commit.getId() + " - " + commit.getShortMessage());
        }
    }
}

关键步骤说明 #

• Blob对象：存储文件的原始内容，是Git中最基础的对象类型。
• Tree对象：相当于目录结构，记录文件路径对应的Blob或子Tree的ID。
• Commit对象：关联Tree（当前仓库状态）、提交信息、作者/提交者信息，以及父Commit（初始提交无父）。
• 更新分支引用：将分支（如master）指向新创建的Commit，让仓库识别到该提交。

这种方式完全在内存中操作Git对象，不需要依赖工作区和索引，适配InMemoryRepository的裸仓库特性。

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