求助：如何实现.NET HealthReport对象的JSON反序列化？

方案1：利用HealthReport静态创建方法+中间DTO #

这是最稳妥且无需编写自定义Converter的方法：

1. 定义与HealthReport结构匹配的DTO类（属性名对应API返回的JSON字段）：

public class HealthReportDto
{
    public HealthStatus Status { get; set; }
    public TimeSpan TotalDuration { get; set; }
    public Dictionary<string, HealthReportEntry> Entries { get; set; }
    public Dictionary<string, object>? Data { get; set; }
}

2. 将JSON内容反序列化为DTO：

// System.Text.Json 示例
var dto = JsonSerializer.Deserialize<HealthReportDto>(jsonContent, new JsonSerializerOptions { PropertyNameCaseInsensitive = true });

// Newtonsoft.Json 示例
var dto = JsonConvert.DeserializeObject<HealthReportDto>(jsonContent);

3. 通过HealthReport.Create静态方法构建真实的HealthReport对象：

var healthReport = HealthReport.Create(
    entries: dto.Entries,
    totalDuration: dto.TotalDuration,
    status: dto.Status
);

// 若返回的JSON包含Data字段，使用重载方法
if (dto.Data != null)
{
    healthReport = HealthReport.Create(
        entries: dto.Entries,
        totalDuration: dto.TotalDuration,
        status: dto.Status,
        data: dto.Data
    );
}

方案2：配置序列化库直接使用有参构造函数 #

如果不想定义DTO，可以尝试让序列化库自动匹配HealthReport的公共有参构造函数：

• System.Text.Json：启用属性名不区分大小写，确保构造参数与JSON字段映射匹配：

var options = new JsonSerializerOptions
{
    PropertyNameCaseInsensitive = true,
    Converters = { new JsonStringEnumConverter() }
};
var healthReport = JsonSerializer.Deserialize<HealthReport>(jsonContent, options);

• Newtonsoft.Json：配置允许使用非默认构造函数（HealthReport构造为公开，此配置主要确保参数映射）：

var settings = new JsonSerializerSettings
{
    ConstructorHandling = ConstructorHandling.AllowNonPublicConstructor,
    MissingMemberHandling = MissingMemberHandling.Ignore,
    Converters = { new StringEnumConverter() }
};
var healthReport = JsonConvert.DeserializeObject<HealthReport>(jsonContent, settings);

注意：此方案依赖JSON字段与HealthReport构造参数的严格匹配，若API返回结构变动可能失效。

是否必须编写自定义JsonConverter？ #

不是必须的。上述两种方案都比自定义Converter更简便。仅当需要全局统一处理HealthReport反序列化，且上述方案无法满足时，才需要编写自定义Converter。

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