Microsoft Graph API 5.44+版本Description字段返回类型异常求助

字段类型检查方法 #

在处理AdditionalData["description"]前，先判断字段实际类型，避免直接强转报错：

if (item.AdditionalData.TryGetValue("description", out var descValue))
{
    // 检查是否为UntypedArray类型
    if (descValue is Microsoft.Kiota.Abstractions.Serialization.UntypedArray descArray)
    {
        // 处理数组类型的描述值
        Console.WriteLine($"描述为数组：{string.Join(", ", descArray)}");
    }
    else if (descValue is string descString)
    {
        // 兼容旧版本的字符串类型
        Console.WriteLine($"描述为字符串：{descString}");
    }
}

问题解决方案 #

1. 适配UntypedArray类型解析 #

如果API返回的description确实从字符串变为数组结构，修改解析逻辑兼容两种类型：

string GetDescription(dynamic item)
{
    if (!item.AdditionalData.TryGetValue("description", out var descValue))
        return string.Empty;

    return descValue switch
    {
        string s => s,
        Microsoft.Kiota.Abstractions.Serialization.UntypedArray arr => arr.Count > 0 ? arr[0].ToString() : string.Empty,
        _ => string.Empty
    };
}

根据业务场景调整数组取值逻辑（比如取第一个元素、拼接所有元素等）。

2. 确认API返回结构是否变更 #

检查调用的Graph API端点官方文档，确认description字段定义是否在新版本中从字符串改为数组。如果是API本身结构变化，需同步调整业务逻辑适配新结构。

3. 检查Kiota序列化配置 #

Kiota（Graph API SDK底层序列化库）高版本可能调整了序列化规则，可尝试显式配置强制解析为字符串：

var serializer = new Microsoft.Kiota.Serialization.Json.JsonSerializationWriter();
serializer.AddAdditionalData("description", item.AdditionalData["description"], typeof(string));
var description = serializer.GetSerializedContent().ReadAsStringAsync().Result;

注：此方法仅适用于序列化规则导致的类型转换问题，若API返回本身是数组则无效。

4. 临时降级或等待官方修复 #

若上述方案无效且业务稳定性要求高，可暂时回退到5.44版本，同时关注Microsoft Graph SDK官方更新日志，确认是否为SDK bug，等待官方修复版本。

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