使用AutoMapper映射时如何让IEnumerable<T>属性保留null而非空数组

问题由代码逻辑错配和框架默认配置共同导致，两层原因叠加让原本为null的MetaData被替换成空数组：

• 代码逻辑bug：当前映射调用直接将类型为ActivitiesDB的requestModel传入AutoMapper，要求输出IEnumerable<DisplayActivity>集合，既没有在映射配置中定义两类对象的映射规则，也没有手动取出requestModel下的Activities属性做映射，这种错配极易触发AutoMapper的默认空集合兜底逻辑。
• 核心配置缺失：AutoMapper默认对可枚举类型做null值兜底——当源端集合属性为null时，默认不传递null值到目标对象，而是自动初始化一个空集合实例，这就是null最终变成[]的直接原因。
• 次要排查点：调整完AutoMapper配置后如果问题依旧，需要检查Cosmos SDK的反序列化规则。SDK默认会正确将数据库存储的null值反序列化到实体属性上，但如果自定义过序列化配置，也可能出现null被替换为空数组的情况。

1. 修正业务代码的映射逻辑 #

不要再把整个ActivitiesDB对象直接丢给Mapper，先显式取出实际的活动集合再做映射：

return new DisplayActivtiesResponse
{
    // 先判断源集合是否为null，避免无意义的映射调用
    DisplayActivties = requestModel?.Activities == null
        ? null
        : mapper.Map<IEnumerable<DisplayActivity>>(requestModel.Activities)
};

2. 调整AutoMapper的全局配置 #

关闭枚举类型的默认null兜底行为，在AutoMapper初始化的位置添加配置：

// 注册AutoMapper时指定全局配置
services.AddAutoMapper(config => {
    // 核心配置：允许把源端的null集合值直接映射到目标属性，不自动创建空集合
    config.AllowNullCollections = true;
}, typeof(Program).Assembly);

注意：AllowNullCollections默认值为false，也就是默认会把null集合替换为空集合，这是框架的内置兜底逻辑。

3. 给映射规则显式补充null值保留配置 #

如果不想改全局配置，也可以在你的MappingProfile里给单个属性单独指定保留null值的规则：

public class MappingProfile : Profile
{
    public MappingProfile()
    {
        CreateMap<Activity, DisplayActivity>()
            // 显式指定MetaData属性允许接收源端的null值，不做空集合兜底
            .ForMember(dest => dest.MetaData, opt => opt.AllowNull())
            .ReverseMap();
    }
}

4. 验证Cosmos SDK的序列化规则 #

如果上述步骤完成后问题依然存在，检查Cosmos客户端初始化时的序列化配置，确保null值不会被替换为空数组：

var cosmosClientOptions = new CosmosClientOptions
{
    SerializerOptions = new JsonSerializerOptions
    {
        DefaultIgnoreCondition = JsonIgnoreCondition.Never
    }
};

当前的LINQ查询语句存在语法错误：

// 原错误语句：括号未闭合，Cosmos LINQ 不支持嵌套过滤数组元素返回单值
var feedIterator = this.cosmosReviewRequestContainer.GetItemLinqQueryable<ActivitiesDB>()
    .Where(q => q.Activities.Where(x => x.ActivityId == activityId)
    .ToFeedIterator();

如果文档结构是单个ActivitiesDB文档下嵌套了Activities数组，需要确保查询语法符合Cosmos的SQL解析规则，避免因为查询返回异常值触发后续的映射兜底逻辑。

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