ASP.NET Core 3.1 Web API重构配置后模型绑定失效如何解决

问题产生原因 #

重构时遗漏了AddNewtonsoftJson()核心方法调用，这是模型绑定失效的根本原因。
AddNewtonsoftJson()并不只是用来配置JSON序列化参数的方法，它承担了两个核心的注册逻辑：

• 将MVC默认基于System.Text.Json的JSON输入/输出格式化器，替换为Newtonsoft.Json实现，这是JSON请求模型绑定的核心依赖
• 完成Newtonsoft.Json相关服务的注册，将MvcNewtonsoftJsonOptions配置项与MVC格式化管道绑定
  你重构后的代码仅通过ConfigureOptions登记了MvcNewtonsoftJsonOptions的配置规则，但没有调用AddNewtonsoftJson()完成上述注册流程：Newtonsoft.Json的格式化器根本没有加入模型绑定管道，你写的所有序列化配置完全不会生效，接口处理JSON请求时仍然使用默认的System.Text.Json做反序列化，和你预期的序列化规则不匹配，直接导致模型绑定失败。

修复方法 #

在AddControllers()后补上无参的AddNewtonsoftJson()调用即可，你封装在ConfigureJsonOptions中的配置会通过.NET选项系统自动生效，不需要在AddNewtonsoftJson的委托中重复编写配置。
修正后的Startup.cs代码：

public virtual void ConfigureServices(IServiceCollection services) => 
    services
        .AddControllers()
        .AddNewtonsoftJson() // 补上核心注册逻辑，无需传入配置委托
        .Services
        .AddCustomConfigureOptions();

public static IServiceCollection AddCustomConfigureOptions(this IServiceCollection services) 
    => services.ConfigureOptions<ConfigureJsonOptions>();

修复后你在ConfigureJsonOptions中配置的格式化缩进、日期解析规则、循环引用忽略、枚举转字符串等逻辑，会自动应用到所有JSON序列化/反序列化场景，包括请求模型绑定、响应序列化等。

内容的提问来源于stack exchange，提问作者santosh kumar patro