使用Microsoft.SharePointOnline.CSOM时ExecuteQueryAsync方法无报错失效

以下是针对同步ExecuteQuery正常、异步ExecuteQueryAsync无异常提示失败问题的排查和解决步骤：

1. 捕获真实异常 #

异步操作的异常如果未被显式捕获，会被静默吞掉，导致无法看到失败原因。必须给await代码块加上try/catch：

try
{
    FileCreationInformation fileCreation = new FileCreationInformation()
    {
        ContentStream = new MemoryStream(File.ReadAllBytes(file.SourceFilePath)),
        Overwrite = true,
        Url = file.FileName
    };
    var uploadFile = folder.Files.Add(fileCreation);
    _clientContext.Load(uploadFile);
    await _clientContext.ExecuteQueryAsync();
}
catch (Exception ex)
{
    // 打印或记录异常，获取具体失败原因
    Console.WriteLine($"上传失败详情：{ex.Message}\n{ex.StackTrace}");
}

2. 修复内存流生命周期问题 #

异步操作时，用File.ReadAllBytes创建的MemoryStream可能在ExecuteQueryAsync完成前被GC回收，导致流提前关闭。改用File.OpenRead并配合using块，确保流在异步操作期间保持打开：

using (var fileStream = File.OpenRead(file.SourceFilePath))
{
    FileCreationInformation fileCreation = new FileCreationInformation()
    {
        ContentStream = fileStream,
        Overwrite = true,
        Url = file.FileName
    };
    var uploadFile = folder.Files.Add(fileCreation);
    _clientContext.Load(uploadFile);
    await _clientContext.ExecuteQueryAsync();
}

3. 避免同步异步混合导致的死锁 #

如果上层调用方法用了.Wait()或.Result阻塞异步代码，会引发死锁，导致ExecuteQueryAsync看似无响应失败。确保整个调用链全异步：

❌ 错误示例：

// 上层同步方法阻塞异步调用
public void StartUpload()
{
    UploadFileAsync().Wait(); // 死锁根源
}

✅ 正确示例：

// 上层方法也用异步
public async Task StartUploadAsync()
{
    await UploadFileAsync();
}

private async Task UploadFileAsync()
{
    using (var fileStream = File.OpenRead(file.SourceFilePath))
    {
        var fileCreation = new FileCreationInformation()
        {
            ContentStream = fileStream,
            Overwrite = true,
            Url = file.FileName
        };
        var uploadFile = folder.Files.Add(fileCreation);
        _clientContext.Load(uploadFile);
        await _clientContext.ExecuteQueryAsync();
    }
}

4. 确保ClientContext的线程安全 #

CSOM的ClientContext实例不是线程安全的，不要在多个异步任务中复用同一个实例。每个异步上传操作应该使用独立的ClientContext，或者确保同一上下文的异步操作按顺序执行。

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