.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