System.Text.Json类库进行json转化时ValueKind:Object问题

当你的使用的Json库是System.Text.Json，而不是Newtonsoft.Json库的时候，你可能遇到以下问题及其解决办法。通常的解决办法是进行一些对应的配置。此外就需要根据情况使用自定义转换器实现你的需求。以下是通常遇到的使用自定义转换器解决的例子:

Q1.当遇到System.InvalidCastException:“Unable to cast object of type ‘System.Text.Json.JsonElement’ to type ‘System.Int32’.”这种错误的时候，是由于System.Text.Json类库进行json转化时，没有明确类型的基础类型导致的。通常可能是某一个属性类型使用object情况。

A1:解决办法是写一个 对象Json转换器 类，如下所示：

  /// <summary>/// 对象Json转化器/// </summary>public class ObjectJsonConverter : JsonConverter<Object>{public override object? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options){switch (reader.TokenType){case JsonTokenType.String:if (DateTime.TryParse(reader.GetString(), out DateTime dateTime))return dateTime;return reader.GetString();case JsonTokenType.Number:if (reader.TryGetInt32(out int intValue))return intValue;else if (reader.TryGetDouble(out double doubleValue))return doubleValue;else if (reader.TryGetDecimal(out decimal decimalValue))return decimalValue;throw new JsonException("Unsupported number format");case JsonTokenType.True:return true;case JsonTokenType.False:return false;case JsonTokenType.Null:return null;case JsonTokenType.StartObject:return JsonSerializer.Deserialize<JsonElement>(ref reader, options);case JsonTokenType.StartArray:return JsonSerializer.Deserialize<JsonElement[]>(ref reader, options);default:throw new JsonException($"Unexpected token type: {reader.TokenType}");}}public override void Write(Utf8JsonWriter writer, object value, JsonSerializerOptions options){if (value == null) writer.WriteNullValue();else if ((value is string || value is DateTime || value is Guid)) writer.WriteStringValue(value.ToString());else if (value is int intValue) writer.WriteNumberValue(intValue);else if (value is double doubleValue) writer.WriteNumberValue(doubleValue);else if (value is decimal decimalValue) writer.WriteNumberValue(decimalValue);else if (value is char charValue) writer.WriteNumberValue(charValue);else if (value is bool boolValue) writer.WriteBooleanValue(boolValue);else if (value is JsonElement jsonElement) jsonElement.WriteTo(writer);else if (value is JsonElement[] jsonElements){writer.WriteStartArray();foreach (var element in jsonElements){element.WriteTo(writer);}writer.WriteEndArray();}else JsonSerializer.Serialize(writer, value, value.GetType(), options);}}

使用如下:

builder.Services.AddJsonOptions(options =>
{// 添加Object格式化转换器options.JsonSerializerOptions.Converters.Add(new ObjectJsonConverter());
});

Q2:在webapi接口返回结果中，时间属性的值返回的形式如:“2024-01-01T10:00:00”,而我们想要的是不带T的格式，比如"2024-01-01 10:00:00"这种。

A2:需要定义一个时间Json转换器DateTimeJsonConverter，代码如下：

 /// <summary>/// 设置Json默认DateTime格式化/// </summary>public class DateTimeJsonConverter : JsonConverter<DateTime>{private readonly string _format;public DateTimeJsonConverter(string format){_format = format;}public override void Write(Utf8JsonWriter writer, DateTime dateTime, JsonSerializerOptions options){writer.WriteStringValue(dateTime.ToString(_format));}public override DateTime Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options){if (reader.TokenType == JsonTokenType.String){if (DateTime.TryParse(reader.GetString(), out DateTime dateTime))return dateTime;}return reader.GetDateTime();}}

使用如下：

builder.Services.AddJsonOptions(options =>
{// 添加时间格式化转换器options.JsonSerializerOptions.Converters.Add(new DateTimeJsonConverter("yyyy-MM-dd HH:mm:ss"));
});

通常完整一点的配置如下：

builder.Services.AddJsonOptions(options =>
{// 设置编码格式
options.JsonSerializerOptions.Encoder = JavaScriptEncoder.Create(UnicodeRanges.All);
// 是否格式化文本
options.JsonSerializerOptions.WriteIndented = true;
//不区分大小写
options.JsonSerializerOptions.PropertyNameCaseInsensitive = true;//不区分大小写
// 字段采用驼峰式命名
options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
// 忽略null值
//options.JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull;
// 忽略只读字段
//options.JsonSerializerOptions.IgnoreReadOnlyProperties = true;
// 对字典的键进行驼峰命名
options.JsonSerializerOptions.DictionaryKeyPolicy = JsonNamingPolicy.CamelCase;
//不允许有注释的不标准json
options.JsonSerializerOptions.ReadCommentHandling = JsonCommentHandling.Disallow;
// 允许属性值末尾存在逗号
options.JsonSerializerOptions.AllowTrailingCommas = true;
// 处理循环引用类型
options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
//枚举类型转string配置（避免转int）
//options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
// 添加时间格式化转换器
options.JsonSerializerOptions.Converters.Add(new DateTimeJsonConverter("yyyy-MM-dd HH:mm:ss"));
// 添加Object格式化转换器
options.JsonSerializerOptions.Converters.Add(new ObjectJsonConverter());
});

Q3:遇到枚举的属性，如果想在接口返回的时候不返回数字，而想返回字符串的情况

A3:在配置的时候进行如下配置即可:

builder.Services.AddJsonOptions(options =>
{//枚举类型转string配置（避免转int）options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
});

此外在枚举的地方添加[JsonConverter(typeof(JsonStringEnumConverter))]特性即可返回字符串,代码如下:

 public class Sample{public int Id { get; set; }public object  Value { get; set; }[JsonConverter(typeof(JsonStringEnumConverter))]public SampleType Type { get; set; }}public enum SampleType{AAAA,BBBB,CCCC}

如果有不够的地方，自行添加。