POST请求如何区分logoUrl未传与显式传null并在响应中正确返回null值

问题根因 #

默认JSON反序列化器处理请求时，字段未提交和显式提交null值两种场景都会将对应属性赋值为null，你当前的逻辑仅通过customUrl != null判断，无法区分这两种场景，导致显式传null时误触发自动生成逻辑。

解决方案 #

通过JSON序列化器的扩展能力标记字段是否被显式提交，分以下两步改造：

1. 改造请求实体类，新增字段提交状态标记 #

主流JSON序列化库都支持识别字段提交状态，根据你用的库二选一即可：

方案A：适配Newtonsoft.Json（默认ASP.NET Core 2.x-3.x）

Newtonsoft.Json原生支持*Specified后缀属性，反序列化时如果请求体出现对应字段，会自动将该属性设为true：

public class Cut
{
    // 原有属性保留
    public string Title { get; set; }
    public string Duration { get; set; }
    public string Album { get; set; }
    public string LogoUrl { get; set; }

    // 新增状态标记字段，无需手动赋值
    public bool LogoUrlSpecified { get; set; }
}

方案B：适配System.Text.Json（默认ASP.NET Core 5+）

用JsonExtensionData捕获所有提交的字段，手动判断logoUrl是否出现在请求中：

public class Cut
{
    // 原有属性保留
    public string Title { get; set; }
    public string Duration { get; set; }
    public string Album { get; set; }
    public string LogoUrl { get; set; }

    // 新增扩展字段捕获所有提交的键值对
    [JsonExtensionData]
    public Dictionary<string, object> ExtensionData { get; set; }

    // 新增判断方法，检查是否提交了logoUrl字段
    public bool IsLogoUrlProvided => ExtensionData?.ContainsKey("logoUrl") ?? false;
}

2. 修改映射与处理逻辑 #

调整AutoMapper映射规则和GetAlbum方法，结合提交状态判断逻辑：

// AutoMapper映射配置修改，传入字段提交状态
CreateMap<Cut, CutData>()
   .ForMember(
       dest => dest.Album,
       opt => opt.MapFrom(src => GetAlbum(
           src.Channel.BaseUrl, 
           src.LogoUrl, 
           // 用Newtonsoft的话传src.LogoUrlSpecified，用System.Text.Json的话传src.IsLogoUrlProvided
           src.LogoUrlSpecified, 
           src.Album
       )));

// GetAlbum方法逻辑调整
private Album GetAlbum(string baseUrl, string customUrl, bool logoUrlProvided, string albumName)
{
    Album album = new Album(baseUrl, albumName);
    // 只要字段被显式提交，不管值是字符串还是null，都用传入的值
    if (logoUrlProvided)
    {
        album.Url = customUrl;
    }
    // 未提交的场景保留默认生成的链接，无需额外处理
    return album;
}

改造后即可完全匹配三种预期逻辑：

• 未提交logoUrl：logoUrlProvided为false，保留自动生成的链接
• 提交字符串值：logoUrlProvided为true，赋值为传入的字符串
• 显式提交null：logoUrlProvided为true，赋值为null

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