如何让System.Text.Json在反序列化构造函数异常中指明错误参数？

适用环境：System.Text.Json及.NET 6、7或更高版本

当反序列化抛出错误Each parameter in the deserialization constructor on type '...' must bind to an object property or field on deserialization.时，可通过以下方法定位具体异常参数：

• 启用详细调试日志
  在日志配置中将System.Text.Json的日志级别设为Debug。调试日志会输出构造函数每个参数的绑定过程，明确显示哪个参数无法匹配到对应的JSON属性或字段。

• 自定义转换器实现诊断
  继承JsonConverter<T>编写自定义转换器，在Read方法中手动校验参数绑定：

  1. 将JSON解析为JsonElement
  2. 遍历目标类型的构造函数参数列表
  3. 逐个检查JsonElement中是否存在匹配的键（注意JsonPropertyName特性指定的别名，以及大小写配置），同时验证类型兼容性
  4. 发现无法匹配的参数时，直接抛出包含参数名称的异常，或输出诊断信息

• 反射对比参数与属性映射
  通过反射获取目标类型的构造函数参数，再对比类型的可序列化属性/字段：

  1. 检查参数名称是否与属性/字段名称一致（含JsonPropertyName别名）
  2. 验证参数类型与对应属性/字段的类型是否兼容（比如可空值类型与非可空类型的差异）
  3. 排查是否存在参数无对应属性/字段，或属性被标记[JsonIgnore]导致无法绑定

• 临时输出对比键名与参数名
  反序列化前临时添加代码，输出JSON的所有键名和构造函数参数名，直接对比找差异：

  // 输出JSON所有键名
  using var jsonDoc = JsonDocument.Parse(jsonString);
  foreach (var prop in jsonDoc.RootElement.EnumerateObject())
  {
      Console.WriteLine($"JSON键: {prop.Name}");
  }
  
  // 输出构造函数参数名（假设使用[JsonConstructor]标记的构造函数）
  var targetType = typeof(YourTargetType);
  var constructor = targetType.GetConstructors()
      .First(c => c.GetCustomAttribute<JsonConstructorAttribute>() != null);
  foreach (var param in constructor.GetParameters())
  {
      Console.WriteLine($"构造函数参数: {param.Name}");
  }
  

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