使用Microsoft.SharePoint.Client下载SharePoint版本文件时遇文件未找到错误

嘿，我看你在使用CSOM下载SharePoint特定版本文件时碰到了“文件未找到”的错误，这大概率是路径处理和冗余操作导致的，我帮你梳理下问题并给出修正方案：

问题根源 #

1. URL路径重复添加斜杠：你的代码里clientContext.Web.GetFileByServerRelativeUrl("/" + vURL)这一行，_version.Url本身已经是完整的服务器相对路径（比如/Shared Documents/ABC/Test.pdf?Version=2.0），再额外加个/会让路径变成//Shared Documents/...，SharePoint自然识别不了正确的文件位置。
2. 冗余的文件获取操作：其实完全没必要通过GetFileByServerRelativeUrl重新获取版本文件，FileVersion对象本身就支持直接打开二进制流，这能简化代码还能避免路径错误。
3. 不必要的LoadQuery使用：直接遍历加载后的versions集合就可以，额外用LoadQuery过滤纯属多此一举。

修正后的代码 #

using (var clientContext = new ClientContext(_SharePointSiteURL))
{
    var onlineCredentials = new SharePointOnlineCredentials(_SharePointSiteUser, securePassword);
    clientContext.RequestTimeout = 10000000;
    clientContext.Credentials = onlineCredentials;

    // 获取目标文件并一次性加载版本信息
    var spFile = clientContext.Web.GetFileByServerRelativeUrl(System.IO.Path.Combine("/Shared Documents/ABC", "Test.pdf"));
    clientContext.Load(spFile, file => file.Versions);
    clientContext.ExecuteQuery();

    if (spFile.Versions != null && spFile.Versions.Count > 0)
    {
        foreach (Microsoft.SharePoint.Client.FileVersion _version in spFile.Versions)
        {
            if (_version.VersionLabel == "2.0")
            {
                // 直接通过FileVersion对象打开二进制流，无需重新定位文件
                ClientResult<System.IO.Stream> data = _version.OpenBinaryStream();
                clientContext.ExecuteQuery();

                using (System.IO.MemoryStream mStream = new System.IO.MemoryStream())
                {
                    data?.Value.CopyTo(mStream);
                    fileBytes = mStream.ToArray();
                    break; // 找到目标版本后立即退出循环，提升效率
                }
            }
        }
    }
}

关键改进点说明 #

• 减少ExecuteQuery调用次数：初始加载时直接指定file => file.Versions，一次性拉取文件和版本信息，避免多次请求SharePoint，提升整体性能。
• 彻底解决路径问题：直接使用FileVersion.OpenBinaryStream()获取版本文件流，跳过手动构建URL的步骤，从根源上避免路径格式错误。
• 优化循环逻辑：找到目标版本后立即break，不需要继续遍历其他版本，减少不必要的资源消耗。
• 简化空值判断：用data?.Value的空值传播运算符替代繁琐的if判断，让代码更简洁易读。

另外，建议你给这段代码加上try-catch异常捕获块，这样能更精准地定位其他潜在问题（比如权限不足、目标版本不存在等），方便后续调试排查。

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