EWS OAuth认证调用FindFolders时随机触发NullReferenceException求助

问题概述 #

使用OAuth认证EWS应用，调用FindFolders()时随机抛出NullReferenceException，非必现。跟踪发现异常源于ServiceRequestBase.WrapStream()方法中contentEncoding为null，尝试替换第三方EWS仓库并添加空检查后，又出现XML功能不兼容问题。

可行解决方法 #

1. 添加重试逻辑（快速生效） #

由于异常是随机触发，在调用FindFolders()时加入重试机制，捕获到NullReferenceException时自动重试：

const int MaxRetries = 3;
FolderCollection folders = null;

for (int retry = 0; retry < MaxRetries; retry++)
{
    try
    {
        folders = ewsClient.FindFolders(WellKnownFolderName.MsgFolderRoot, new FolderView(15));
        break;
    }
    catch (NullReferenceException)
    {
        if (retry == MaxRetries - 1) throw; // 最后一次重试失败则抛出原异常
        await Task.Delay(TimeSpan.FromSeconds(1));
    }
}

if (folders != null)
{
    foreach (var folder in folders)
        Console.WriteLine(folder.DisplayName);
}

2. 修复EWS库的空引用问题 #

官方EWS Managed API存在未修复的空引用bug，可通过反射修改ServiceRequestBase.WrapStream()方法，注入空检查逻辑：

// 注意：反射操作需谨慎，仅在测试环境验证后使用
var serviceRequestType = typeof(ServiceRequestBase);
var wrapStreamMethod = serviceRequestType.GetMethod("WrapStream", BindingFlags.NonPublic | BindingFlags.Instance);
if (wrapStreamMethod != null)
{
    // 使用动态代理或IL注入工具（如Harmony）修改方法逻辑，添加contentEncoding空检查
    // 示例伪代码（需依赖第三方库实现）：
    // Harmony.Patch(wrapStreamMethod, prefix: new HarmonyMethod(typeof(YourPatchClass), nameof(YourPatchClass.WrapStreamPrefix)));
}

// 对应的空检查前缀方法
public static bool WrapStreamPrefix(Stream responseStream, ref Stream __result, string contentEncoding)
{
    if (contentEncoding == null)
    {
        __result = responseStream;
        return false; // 跳过原方法执行
    }
    return true; // 执行原方法
}

3. 迁移到Microsoft Graph API（长期方案） #

微软已逐步弃用EWS，推荐迁移到Microsoft Graph API，它的OAuth认证更稳定，功能覆盖EWS核心场景。获取邮箱文件夹的示例代码：

var graphClient = new GraphServiceClient(new DelegateAuthenticationProvider(async (requestMessage) =>
{
    var authResult = await cca.AcquireTokenForClient(new[] { "https://graph.microsoft.com/.default" }).ExecuteAsync();
    requestMessage.Headers.Authorization = new AuthenticationHeaderValue("Bearer", authResult.AccessToken);
}));

var folders = await graphClient.Users["target-mail@domain.com"].MailFolders
    .Request()
    .Top(15)
    .GetAsync();

foreach (var folder in folders)
    Console.WriteLine(folder.DisplayName);

4. 校验请求头完整性 #

随机异常可能源于请求头偶尔未正确传递，添加请求日志验证每次请求的X-AnchorMailbox等头信息：

ewsClient.OnBeforeRequest += (sender, args) =>
{
    foreach (var header in args.RequestHeaders)
        Console.WriteLine($"{header.Key}: {header.Value}");
};

总结 #

优先用重试逻辑快速解决当前问题，同时规划迁移到Graph API避免EWS的后续兼容性风险。若必须保留EWS，反射修复空引用是可行方案，但需做好测试。

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