ASP.NET Core自定义类型模型绑定应采用哪种实现方案？

核心问题解决方案 #

你当前的场景使用了[FromBody]接收JSON请求体，ASP.NET Core默认会通过System.Text.Json序列化器完成反序列化绑定，该链路不会触发普通模型绑定器、也不会调用TypeConverter，所以你之前的方案都不生效。
你应该优先实现System.Text.Json 原生的JsonConverter<Id>，将其注册到全局JSON配置中即可实现Id类型的自动转换。

三个技术的适用场景 #

• JsonConverter（包含Newtonsoft.Json和System.Text.Json的实现）：仅作用于JSON序列化/反序列化链路，适用于[FromBody]参数绑定、JSON格式响应输出的场景，和序列化逻辑深度整合，性能最优，是JSON交互场景下的首选方案。
• TypeConverter：属于.NET 平台通用的类型转换组件，仅作用于非JSON的简单参数绑定场景，比如路由参数、Query参数、Form表单参数的转换，也可被Convert.ChangeType等通用转换逻辑调用，适合简单值类型的跨场景转换需求，但对JSON序列化链路无效。
• IModelBinder：适用于复杂的自定义绑定场景，比如需要从路由、Query、Header、请求体等多个来源拼接构造模型、绑定过程需要依赖服务容器中的其他服务、需要全局控制某类模型的绑定逻辑，实现复杂度最高，仅在前两种方案无法满足需求时使用。

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