SharePoint CSOM ClientContext内存占用过高问题求助

这个问题我在做大规模SharePoint文档迁移项目时踩过坑——ClientContext内部的ObjectPathIdentity字典确实是罪魁祸首，它会持续跟踪所有通过Context加载或创建的对象，批量操作时这个字典会不断膨胀，直接导致内存占用飙升。下面是几个亲测有效的解决方案，按推荐优先级排序：

1. 按批次创建并销毁ClientContext #

不要全程用同一个Context处理所有文档，而是每处理一批（比如50-100个）就新建一个Context，用完立即Dispose。每个Context的缓存是独立的，销毁旧Context时，对应的ObjectPathIdentity字典也会被GC回收，从根源上避免内存累积。

示例代码：

var siteUrl = "https://your-sharepoint-site.com";
var credentials = new SharePointOnlineCredentials("username", securePassword);
// 把文档分成批次，比如每批50个
var documentBatches = SplitIntoBatches(localDocuments, batchSize: 50);

foreach (var batch in documentBatches)
{
    using (var ctx = new ClientContext(siteUrl))
    {
        ctx.Credentials = credentials;
        // 处理当前批次的文档上传
        UploadBatchOfDocuments(ctx, batch);
    } // 自动Dispose，释放Context的所有缓存资源
}

2. 使用File.SaveBinaryDirect跳过对象跟踪 #

如果你的场景只是上传文档（不需要后续操作上传后的File对象），强烈推荐用静态方法File.SaveBinaryDirect。这个方法直接将文件流上传到SharePoint，不会在ClientContext中创建或跟踪任何对象，自然不会向ObjectPathIdentity字典添加条目，内存占用会非常稳定。

示例代码：

using (var ctx = new ClientContext(siteUrl))
{
    ctx.Credentials = credentials;
    var web = ctx.Web;
    ctx.Load(web);
    ctx.ExecuteQuery(); // 只加载Web的基础信息，避免多余缓存

    foreach (var localFile in localDocuments)
    {
        // 构建目标文件夹的Server相对路径
        var targetFolderUrl = $"{web.ServerRelativeUrl}/Documents/TargetFolder";
        using (var fileStream = new FileStream(localFile.FullName, FileMode.Open))
        {
            // 直接上传，不跟踪对象
            Microsoft.SharePoint.Client.File.SaveBinaryDirect(
                ctx, 
                $"{targetFolderUrl}/{Path.GetFileName(localFile.FullName)}", 
                fileStream, 
                overwrite: true
            );
        }
    }
}

3. 反射清理内部缓存（应急方案） #

如果必须使用同一个Context完成所有操作，可以通过反射调用ClientContext内部的ClearObjectCache方法来手动清空ObjectPathIdentity字典。不过要注意：这个方法是非公开的，不同版本的CSOM库可能会有变化，而且清空缓存后，之前加载的对象会失效，所以只能在一批操作完成、且后续不再使用这些对象时调用。

示例代码：

// 在一批操作完成后，清理缓存
var clearCacheMethod = typeof(ClientContext).GetMethod(
    "ClearObjectCache", 
    System.Reflection.BindingFlags.Instance | System.Reflection.BindingFlags.NonPublic
);
if (clearCacheMethod != null)
{
    clearCacheMethod.Invoke(ctx, null);
}

总结 #

优先选择批次化Context或SaveBinaryDirect上传，这两个方案安全且无副作用；反射清理只适合特殊场景下的应急处理，使用前一定要做好测试。

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