.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")]只能指定类型标识字段名,还需要告诉转换器每个标识字符串对应哪个具体派生类型,否则反序列化时无法找到匹配目标类型。
两种配置方式二选一即可:- 在派生类上追加映射特性,和基类的配置配套:
[JsonSubtypes.KnownSubType(typeof(DayOfWeekPointRule), "DayOfWeekPointRule")] public class DayOfWeekPointRule : BasePointRule { // 原有类逻辑保持不变 } - 在Newtonsoft.Json全局配置中做映射,无需修改派生类代码:
services.AddControllers().AddNewtonsoftJson(options => { // 注意如果基类上已经标注了JsonConverter特性,这里不需要重复添加转换器实例,避免重复注册 options.SerializerSettings.Converters.Add( new JsonSubtypes("PointType") .WithSubType(typeof(DayOfWeekPointRule), "DayOfWeekPointRule") ); });
- 在派生类上追加映射特性,和基类的配置配套:
- 验证生效逻辑
修复后可在控制器方法内打断点,确认入参rule的实际运行时类型为DayOfWeekPointRule,即代表多态反序列化流程正常跑通。
内容的提问来源于stack exchange,提问作者EyreCraggs
相关产品推荐
相关产品推荐

