.NET Core 内置的 System.Text.Json 使用注意

System.Text.Json 是 .NET Core 3.0 新引入的高性能 json 解析、序列化、反序列化类库，武功高强，但毕竟初入江湖，炉火还没纯青，使用时需要注意，以下是我们在实现使用中遇到的一下问题。

1）默认设置下中文会被编码

序列化时中文会被编码，详见博问 .NET Core 3.0 中使用 System.Text.Json 序列化中文时的编码问题 。

解决方法：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers().AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Encoder = JavaScriptEncoder.Create(UnicodeRanges.All);
    });
}

2）不能序列化公有字段（成员变量），只能序列化公有属性。

比如

public class FollowBloggerRequest
{
    public Guid blogUserGuid;
}

要改为

public class FollowBloggerRequest
{
    public Guid blogUserGuid { get; set; }
}

3）全是数字的字符串不能隐式反序列化为 int 类型

比如 { "postId": "12345" } 不能反序列化为 int PostId ，github 上的相关 issue : System.Text.Json: Deserialization support for quoted numbers

4）对于枚举类型属性值（非数字型）的序列化，需要加 [JsonStringEnumConverter] 特性

比如

[JsonConverter(typeof(JsonStringEnumConverter))]
public SiteCategoryType CategoryType { get; set; }

Json.NET 对应的是 StringEnumConverter

5）反序列化 Guid 的问题

详见博问：https://q.cnblogs.com/q/120383/

注：对应类型转换问题，可以通过实现自定义 JsonConverter<T> 解决，参考 corefx#36639 (comment)