ASP.NET 6 API搭配React客户端如何区分请求属性未传与传值为null

默认的ASP.NET Core模型绑定搭配System.Text.Json/Newtonsoft.Json反序列化逻辑，确实无法直接区分「请求未携带某字段」和「请求显式给某字段赋值null」两种场景——两种场景下，对应可空属性的解析结果都是null，无法直接判断客户端传参意图。可通过以下两种生产可用的方案实现需求：

方案1：利用Json扩展数据属性（零侵入绑定逻辑，适合单接口/少量DTO场景） #

这个方案不需要修改全局模型绑定规则，只需要在对应DTO上增加一个带[JsonExtensionData]特性的字典属性，用来捕获请求中实际传递的所有字段名：

1. DTO定义示例

   // 以System.Text.Json为例，Newtonsoft.Json逻辑完全一致
   public class UserUpdateRequest
   {
       public int? Age { get; set; }
       public int? Size { get; set; }
   
       // 存储请求中实际传递的所有字段
       [System.Text.Json.Serialization.JsonExtensionData]
       public Dictionary<string, JsonElement> RequestedFields { get; set; } = new();
   }
   

2. 更新逻辑实现
   • 先从数据库查询出原始的User实体
   • 遍历DTO上的业务属性，判断当前属性名是否存在于RequestedFields字典的Key集合中
   • 若存在：说明请求显式传递了该字段，不管值是null还是具体数值，都将DTO的属性值赋值给原始实体对应字段
   • 若不存在：说明请求未携带该字段，直接跳过，保留数据库原始值
3. 场景验证
   • 收到请求{"User":{"Age":15}}时，RequestedFields中仅存在Age键，因此仅更新Age为15，Size保留数据库原值180
   • 收到请求{"User":{"Age":15,"Size":null}}时，RequestedFields中同时存在Age和Size键，因此更新Age为15、Size为null

方案2：自定义可空字段包装器+Json转换器（全局通用，适合多接口场景） #

如果项目中大量接口需要实现这类部分更新的逻辑，可以实现一个通用的字段包装类型，配合自定义Json转换器全局注册，不需要每个DTO都加扩展字典：

1. 定义通用字段包装结构体，用来标记字段是否被显式传递

   public struct UpdateField<T>
   {
       // 标记当前字段是否在请求中被显式传递
       public bool IsProvided { get; private set; }
       // 存储请求传递的实际值
       public T? Value { get; private set; }
   
       public void SetValue(T? value)
       {
           IsProvided = true;
           Value = value;
       }
   
       // 支持隐式转换，简化赋值操作
       public static implicit operator UpdateField<T>(T value)
       {
           return new UpdateField<T> { IsProvided = true, Value = value };
       }
   }
   

2. 编写对应的Json转换器，反序列化时只要读取到对应字段，就标记IsProvided = true，未读取到则保持默认false
3. DTO定义直接使用包装类型

   public class UserUpdateRequest
   {
       public UpdateField<int?> Age { get; set; }
       public UpdateField<int?> Size { get; set; }
   }
   

4. 更新逻辑：遍历DTO属性，只要属性的IsProvided为true，就更新实体对应字段，否则跳过保留原值。
5. 该方案可以将Json转换器全局注册到MVC的Json序列化配置中，所有DTO自动生效，不需要额外配置。

注意：启用C#可空引用类型（Nullable Reference Types）无法解决该问题，默认反序列化逻辑依然无法区分未传参和显式传null的场景，不要依赖可空类型的注解做判断。

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