.NET WebAPI 自定義 NullableConverter 解決可為空類型欄位入參“”空字元觸發轉換異常問題

最近在項目中啟用了Nullable 可為空的類型，這個特性確實很好用，在 WebAPI 的入參上可以直接採用 ？ 來標記一個欄位是否允許為空，但是使用過程中遇到瞭如下一個問題，比如創建部門介面

我們定義入參模型如下：

public class DtoDepartment
{
    /// <summary>
    /// 部門名稱
    /// </summary>
    public string Name { get; set; }

    /// <summary>
    /// 上級部門ID
    /// </summary>
    public Guid? ParentId { get; set; }
}

我們這裡將上級部門ID定義為可以為空的類型，因為有些部門不存在上級部門
然後定義這樣一個介面

[HttpPost("CreateDepartment")]
public bool CreateDepartment(DtoDepartment department)
{
    //省略業務邏輯
    return true;
}

當前端請求的時候傳入如下Json 時則就會觸發異常

{
  "name": "商務一部",
  "parentId": ""
}

異常內容為：

{
  "errMsg": "The department field is required. | The JSON value could not be converted to System.Nullable`1[System.Guid]. Path: $.parentId | LineNumber: 2 | BytePositionInLine: 16."
}

像這樣的情況是因為雖然我們定義的 Dto 允許上級部門ID欄位為空，但是前端調用的時候 parentId 實際傳入的是 "" 空字元串，當空字元串給 Guid? 轉換的時候就會產生這樣的異常，當遇到這樣的情況時，我們可以要求前端調整 JSON 格式如下

{
  "name": "商務一部",
  "parentId": null
}

前端只要給 parentId 的賦值從 "" 調整為 null 之後我們的介面就可以正常運行了，但是有的時候前端的組件這裡取值可能是和一些組件庫綁定的，不太方便綁定預設值為 null，很多情況下組件庫組件的預設值都是 "" 空字元串的形式，所以經過和前端同事多次溝通之後想著從後端徹底解決這個問題，經過研究之後編寫了下麵的 NullableConverter 轉換器，只要在項目啟動的時候註冊到 AddJsonOptions 其中即可。

using System.Text.Json;
using System.Text.Json.Serialization;

namespace Common.JsonConverter
{
    public class NullableConverter<T> : JsonConverter<T?> where T : struct
    {

        public override T? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
        {
            if (reader.TokenType == JsonTokenType.String)
            {
                if (string.IsNullOrEmpty(reader.GetString()) || string.IsNullOrWhiteSpace(reader.GetString()))
                {
                    return null;
                }
            }
            return JsonSerializer.Deserialize<T>(ref reader, options);
        }


        public override void Write(Utf8JsonWriter writer, T? value, JsonSerializerOptions options)
        {
            JsonSerializer.Serialize(writer, value!.Value, options);
        }

    }
}

上面我們只是用 Guid? 舉了一個例子，實際情況下

• DateTime?
• DateTimeOffset?
• long?
• int?
• double?
• decimal?
• float?
• Guid?
• bool?

都有可能存在這個問題，所以我們為這幾種類型都配置了這個可為空類型轉換器。這樣前端在調用介面時配到這類型的欄位，傳 "" 和 null 我們後端就都可以接收了，收到之後欄位的值都是 null

我這裡項目採用的是微軟的 System.Text.Json 處理的 Json 序列化，註冊配置 NullableConverter 代碼如下：

#region 註冊 Json 序列化配置
builder.Services.AddControllers().AddJsonOptions(options =>
{
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<DateTime>());
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<DateTimeOffset>());
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<long>());
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<int>());
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<double>());
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<decimal>());
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<float>());
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<Guid>());
    options.JsonSerializerOptions.Converters.Add(new Common.JsonConverter.NullableConverter<bool>());
});
#endregion

至此 .NET WebAPI 自定義 NullableConverter 解決可為空類型欄位入參“”空字元觸發轉換異常問題 就講解完了，有任何不明白的，可以在文章下麵評論或者私信我，歡迎大家積極的討論交流，有興趣的朋友可以關註我目前在維護的一個 .NET 基礎框架項目，項目地址如下
https://github.com/berkerdong/NetEngine.git
https://gitee.com/berkerdong/NetEngine.git