C#中使用AutoMapper实现PATCH请求下非空实体的部分更新最佳实践

核心原则 #

PATCH 场景的核心是只更新DTO里明确传递的非空值，避免默认值覆盖数据库原有数据，同时尽量减少重复配置，防止新增实体/枚举时因漏写规则产生bug。AutoMapper 原生提供了相应机制，无需为每个实体单独编写自定义映射规则。

1. 全局配置映射条件（一劳永逸） #

针对所有可空值类型（包括可空枚举）和集合，直接设置全局映射规则：仅当源属性（DTO中的属性）不为 null 时，才执行映射操作。新增实体或枚举时，该规则会自动生效。

// 全局配置示例
var configuration = new MapperConfiguration(cfg =>
{
    // 处理所有可空值类型：仅当DTO属性不为null时才映射
    cfg.ForAllPropertyMaps(map => 
        map.SourceType.IsGenericType && 
        map.SourceType.GetGenericTypeDefinition() == typeof(Nullable<>),
        (map, opts) => opts.Condition((src, dest, srcVal) => srcVal != null));
    
    // 处理集合：DTO集合为null时不覆盖原有数据，传递空集合才会清空目标集合
    cfg.ForAllPropertyMaps(map => typeof(ICollection<>).IsAssignableFrom(map.SourceType),
        (map, opts) => opts.Condition((src, dest, srcVal) => srcVal != null));
});

2. 个别属性特殊处理（按需覆盖） #

如果某些属性需要例外规则（比如允许DTO传null来更新目标值），可以在单个实体的映射配置中单独设置：

// 单个实体映射示例
cfg.CreateMap<EntityRequestDto, Entity>()
    .ForMember(dest => dest.SpecialProperty, opt => 
        opt.Condition((src, dest, srcVal) => srcVal != null)); // 可根据需求自定义条件，比如允许null映射

3. 配合 EF Core 跟踪机制优化更新 #

Service 层从数据库获取实体时，不要使用 AsNoTracking。AutoMapper 映射的是 EF Core 已跟踪的实体对象，映射完成后直接调用 SaveChangesAsync 即可，EF 会自动检测并保存变更，无需手动标记实体状态。

4. 更新后的实体验证 #

更新完成后，需确保必填字段未被意外置空：

• 可使用数据注解（[Required]）结合 Validator.TryValidateObject 完成验证
• 也可在 Service 层手动检查核心必填字段的有效性

避坑要点 #

• 枚举类型：DTO中的枚举属性必须设为可空类型（如 OrderStatus?），这样全局的Nullable规则才能生效，避免将null映射为枚举默认值
• 集合类型：若需清空数据库中的集合，DTO需传递空集合（new List<Item>()）而非null；传递null时，全局规则会跳过映射，保留原有集合数据
• 值类型默认值：比如DTO中的int属性设为 int?，若用户确实需要将值改为0，需明确传递0，不能依赖null的默认映射（null会被全局规则跳过）

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