You need to enable JavaScript to run this app. .NET 5 WebApi使用JsonSubTypes多态反序列化失败但控制台应用正常
优惠活动
大模型
产品
解决方案
定价
更多

.NET 5 WebApi使用JsonSubTypes多态反序列化失败但控制台应用正常

问题根因

你遇到的异常触发在ASP.NET Core MVC的ComplexObjectModelBinder环节,根本没有进入JSON反序列化流程。
默认模型绑定器收到BasePointRule类型的参数时,会首先尝试直接实例化该类型完成绑定逻辑——因为它是抽象类无法直接创建实例,所以直接抛出异常。哪怕你配置了JsonConverter、切换了Newtonsoft.Json,只要请求没走Body解析通道,这些配置完全不会生效。

之前的测试结果也能对应上这个逻辑:

  • 控制台应用测试时,你手动调用JsonConvert.DeserializeObject直接触发反序列化逻辑,没有MVC模型绑定的前置拦截,所以JsonSubtypes的转换器可以正常工作
  • 把参数换成具体派生类时,默认绑定器可以直接实例化该具体类型,不会触发抽象类的实例化报错,因此看起来“功能正常”

修复方案

  • 给抽象类型的请求参数显式标记[FromBody]特性
    这是同类问题的核心原因:没有显式标记来源的复杂类型参数,MVC会默认从路由、查询字符串、表单值来源尝试绑定,完全不会读取请求Body里的JSON内容,自然也不会触发你配置的多态反序列化逻辑。
    修改后的控制器代码:
    [HttpPost("AddPointRule")]
    public IActionResult AddPointRule([FromBody] BasePointRule rule)
    {
        ConfigurationService.AddPointRule(rule);
        return Ok();
    }
    
  • 补全JsonSubtypes的派生类型映射配置
    仅在抽象基类上标记[JsonConverter(typeof(JsonSubtypes), "PointType")]只能指定类型标识字段名,还需要告诉转换器每个标识字符串对应哪个具体派生类型,否则反序列化时无法找到匹配目标类型。
    两种配置方式二选一即可:
    1. 在派生类上追加映射特性,和基类的配置配套:
      [JsonSubtypes.KnownSubType(typeof(DayOfWeekPointRule), "DayOfWeekPointRule")]
      public class DayOfWeekPointRule : BasePointRule
      {
          // 原有类逻辑保持不变
      }
      
    2. 在Newtonsoft.Json全局配置中做映射,无需修改派生类代码:
      services.AddControllers().AddNewtonsoftJson(options =>
      {
          // 注意如果基类上已经标注了JsonConverter特性,这里不需要重复添加转换器实例,避免重复注册
          options.SerializerSettings.Converters.Add(
              new JsonSubtypes("PointType")
                  .WithSubType(typeof(DayOfWeekPointRule), "DayOfWeekPointRule")
          );
      });
      
  • 验证生效逻辑
    修复后可在控制器方法内打断点,确认入参rule的实际运行时类型为DayOfWeekPointRule,即代表多态反序列化流程正常跑通。

内容的提问来源于stack exchange,提问作者EyreCraggs

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.04 17:06:08