C#应用开发中Firestore数组类型转换返回null问题求助

问题根因 #

Firestore .NET SDK 调用ToDictionary()方法时，会自动将Firestore中的数组字段反序列化为List<object>类型，而非强类型的string[]。二者不存在继承或兼容的隐式转换关系，因此使用as string[]进行类型转换时会直接返回null。

解决方案 #

方案一：手动转换列表元素（适合临时读取场景） #

先将字段值转为SDK实际返回的列表类型，再遍历元素转换为字符串数组：

if (dic.ContainsKey("offers") && dic["offers"] is List<object> offerList)
{
    // 转换元素为string，自动过滤空值（可根据需求调整）
    string[] offersinarray = offerList
        .Where(item => item != null)
        .Select(item => item.ToString())
        .ToArray();
    
    if (offersinarray.Length > 0)
    {
        // 业务逻辑
    }
}

方案二：强类型反序列化（推荐，适合长期维护场景） #

避免使用动态字典读取，直接将文档反序列化为自定义强类型模型，SDK会自动完成类型转换：

1. 先定义与Firestore文档结构对应的模型类：

[FirestoreData]
public class AstrologerInfo
{
    // 对应Firestore中的offers字段
    [FirestoreProperty]
    public string[] Offers { get; set; }
    // 其他需要的字段按相同规则定义即可
}

2. 读取文档时直接转换为模型：

CollectionReference citiesRef = db.Collection("Astrologer");
DocumentSnapshot documentSnapshot = await citiesRef.Document(docid).GetSnapshotAsync();
AstrologerInfo astroData = documentSnapshot.ConvertTo<AstrologerInfo>();

// 直接判断使用数组
if (astroData?.Offers != null && astroData.Offers.Length > 0)
{
    // 业务逻辑
}

注意事项 #

• 若Firestore中的offers字段存在数组元素为null的情况，手动转换时需增加空值过滤逻辑，避免抛出空引用异常
• string[]类型的数组长度属性为Length，而非List<T>的Count，注意判断逻辑的属性调用，避免编译错误
• 若数组存储的不是字符串类型，需将模型中的Offers属性定义为对应类型（如int[]、自定义嵌套类数组等），无需手动处理转换

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