使用LibGit2Sharp在IIS部署后无法访问Git仓库分支问题

我之前碰到过一模一样的情况——调试时跑起来顺得不行，一部署到IIS就报仓库找不到的错，核心问题就是权限和运行身份不匹配，下面给你一步步拆解解决：

问题根源 #

调试模式下，你的代码是用当前登录用户的身份运行的，这个用户自然有权限访问自己Documents目录下的Git仓库；但发布到IIS后，Web服务是用IIS应用池的默认受限账户运行的，这个账户根本没权限碰你的个人用户目录，所以才会抛出RepositoryNotFoundException。

具体解决方案 #

1. 给应用池账户添加仓库目录的访问权限 #

• 打开IIS管理器，找到你的Web服务对应的应用池，右键选「高级设置」；
• 查看「标识」字段，默认可能是ApplicationPoolIdentity或者Network Service；
• 找到Git仓库目录C:\Users\MyUser\Documents\MyRepository，右键「属性」→「安全」→「编辑」→「添加」；
• 把刚才看到的应用池账户加进去（比如IIS AppPool\你的应用池名称，如果是Network Service直接搜这个账户），给它赋予读取和执行、列出文件夹内容、读取这三个权限；
• 记得勾选「将所有子对象权限条目替换为可继承的权限条目」，确保隐藏的.git文件夹（Git仓库核心）也能被访问到。

2. 替换硬编码的绝对路径（可选但强烈推荐） #

硬写绝对路径在部署时很容易踩坑，建议把路径配置到Web.config里：

<configuration>
  <appSettings>
    <add key="GitRepositoryPath" value="C:\Users\MyUser\Documents\MyRepository" />
  </appSettings>
</configuration>

然后在代码里读取这个配置：

[WebMethod]
public string GetStringOfBranches()
{
    string gitPath = ConfigurationManager.AppSettings["GitRepositoryPath"];
    using (var repo = new Repository(gitPath))
    {
        // 把分支列表拼接成字符串返回，替代调试用的Console输出
        return string.Join(", ", repo.Branches.Select(b => b.FriendlyName));
    }
}

如果是部署到服务器，建议把Git仓库放到非用户目录的位置（比如D:\GitRepositories\MyRepository），权限配置更方便，也能避开用户目录的权限限制。

3. 验证仓库路径的正确性 #

可以临时加个日志输出（比如写到文本文件），确认实际读取到的路径是否正确：

// 临时日志，排查路径问题
File.WriteAllText(@"C:\Temp\GitPathLog.txt", gitPath);

还要确保路径指向的是包含.git隐藏文件夹的目录——LibGit2Sharp必须能访问这个文件夹才能识别为有效Git仓库。

附你的原始代码和报错信息：

原始代码 #

[WebMethod]
public string GetStringOfBranches() { 
    string gitPath = @"C:\Users\MyUser\Documents\MyRepository"; 
    using (var repo = new Repository(gitPath)) { 
        //Console.WriteLine("start"); 
        foreach (var branch in repo.Branches) { 
            Console.WriteLine(branch.FriendlyName); 
        } 
    } 
}

报错信息 #

LibGit2Sharp.RepositoryNotFoundException: Path 'C:\Users\MyUser\Documents\MyRepository' doesn't point at a valid Git repository or workdir. at LibGit2Sharp.Core.Proxy.git_repository_open(String path) at LibGit2Sharp.Repository..ctor(String path, RepositoryOptions options, RepositoryRequiredParameter requiredParameter) at WebSrv3.wsGitInterface.GetStringOfBranches() in C:\Users\MyUser\Documents\Visual Studio 2017\Projects\WebSrv3\WebSrv3\MyWs.asmx.cs:line 58

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