ABP框架如何实现实体部分更新 避免未传字段被覆盖为null

方案1：优化现有AutoMapper配置（改造成本最低） #

你现有的AutoMapper全局配置逻辑是对的，可空DateTime的映射异常一般是序列化/反序列化配置问题导致的，不需要写临时赋值代码，按下面两步调整即可：

1. 先确认你的API序列化配置，确保未传递的可空属性反序列化后值为null，而不是默认值：
   如果用的是System.Text.Json，在模块配置类里加：

Configure<JsonOptions>(options =>
{
    options.JsonSerializerOptions.IgnoreNullValues = false;
    options.JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.Never;
});

如果用的是Newtonsoft.Json，配置：

Configure<NewtonsoftJsonOptions>(options =>
{
    options.SerializerSettings.NullValueHandling = NullValueHandling.Include;
    options.SerializerSettings.DefaultValueHandling = DefaultValueHandling.Ignore;
});

2. 原有AutoMapper配置保留，不需要修改，可空值类型只要前端没传，反序列化后就是null，AutoMapper就会跳过映射，保留实体原有值。
   这种方案唯一的限制就是更新DTO所有字段必须设为可空，以及你如果要主动把某个字段设为null的话，需要显式传null值，符合通用接口设计规范。

方案2：手动控制EF Core字段更新（最稳定，适合对数据准确性要求高的场景） #

不用依赖AutoMapper的映射规则，直接在更新逻辑里手动判断哪些字段需要更新，性能和可控性最高：

public override async Task<UserDto> UpdateAsync(UpdateUserDto input)
{
    var user = await _userManager.GetUserByIdAsync(input.Id);
    // 逐个字段判断，有值才更新
    if (input.Name != null) user.Name = input.Name;
    if (input.Surname != null) user.Surname = input.Surname;
    if (input.FatherName != null) user.FatherName = input.FatherName;
    if (input.BirthDate.HasValue) user.BirthDate = input.BirthDate.Value;
    if (input.EmailAddress != null) user.EmailAddress = input.EmailAddress;
    if (input.PhoneNumber != null) user.PhoneNumber = input.PhoneNumber;
    if (input.DepartmentId.HasValue) 
    {
        user.DepartmentId = input.DepartmentId.Value;
        var department = await _departmentRepository.GetAsync(input.DepartmentId.Value);
        user.ManagerId = department.ManagerId;
    }
    if (input.PositionId.HasValue) user.PositionId = input.PositionId.Value;
    
    user.SetNormalizedNames();
    await _userManager.UpdateAsync(user);
    return await GetAsync(input.Id);
}

这种方案没有任何隐式逻辑，不会出现意外更新的问题，字段少的情况下非常推荐。

方案3：使用JsonPatch（最符合REST规范，适合前端需要灵活更新的场景） #

HttpPatch不需要编写大量额外代码，ABP框架已经原生支持JsonPatch操作，按下面配置即可：

1. 先安装对应包：Microsoft.AspNetCore.Mvc.NewtonsoftJson
2. 在模块类中启用Newtonsoft.Json和Patch支持：

public override void ConfigureServices(ServiceConfigurationContext context)
{
    context.Services.AddControllers().AddNewtonsoftJson();
}

3. 新增Patch接口：

[HttpPatch]
[Route("{id}")]
public async Task<UserDto> PatchAsync(long id, [FromBody] JsonPatchDocument<UpdateUserDto> patchDoc)
{
    var user = await _userManager.GetUserByIdAsync(id);
    var dto = ObjectMapper.Map<User, UpdateUserDto>(user);
    patchDoc.ApplyTo(dto);
    // 校验DTO合法性
    Validate(dto);
    ObjectMapper.Map(dto, user);
    user.SetNormalizedNames();
    await _userManager.UpdateAsync(user);
    return await GetAsync(id);
}

前端调用的时候按JsonPatch规范传操作指令即可，比如只更新姓名：

[
  { "op": "replace", "path": "/name", "value": "Василий" },
  { "op": "replace", "path": "/surname", "value": "Пупкин" }
]

这种方案不需要前端维护整个DTO，只需要传要修改的字段，非常适合复杂实体的部分更新场景。

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