ASP.NET Core模型绑定默认值设置方法及替代方案

该说法存在场景局限性，并非完全正确：

• 对非JSON来源的模型绑定（包括[FromQuery]查询参数、[FromForm]表单参数、[FromRoute]路由参数）：System.ComponentModel.DefaultValueAttribute本身是正常生效的，框架默认模型绑定器会在对应参数缺失时，自动读取特性标记的默认值完成赋值。
• 对[FromBody]标记的JSON请求体绑定（即System.Text.Json负责反序列化的场景）：.NET Core 3.0及以上版本的默认配置下，[DefaultValue]特性确实不会被自动识别——这是因为System.Text.Json的默认反序列化逻辑没有主动读取该特性的实现，也是网传“特性失效”的核心原因，和早期用JSON.NET（Newtonsoft.Json）时的默认行为有差异。

按推荐优先级从高到低排列：

1. 使用C#原生属性初始化器/构造函数赋值（首选） #

这是无额外依赖、无兼容问题、可读性最高的方案，不区分绑定源，只要模型实例化时没有传入对应属性值，就会自动使用预设默认值，示例代码：

public class CreateOrderRequest
{
    // 直接通过属性初始化器设置默认值
    public int Quantity { get; set; } = 1;
    public string OrderStatus { get; set; } = "Pending";
    public bool NeedInvoice { get; set; } = false;
    // 必填字段也可以设置空默认值规避空引用警告
    [Required]
    public string ReceiverName { get; set; } = string.Empty;
}

如果使用record类型定义模型，直接在构造函数参数上设置默认值即可，效果完全一致。

2. 配置System.Text.Json使其识别[DefaultValue]特性 #

如果存量代码已经大量使用[DefaultValue]特性，不想全量改造为属性初始化，可以在Program.cs中调整JSON序列化配置，让反序列化逻辑主动读取该特性：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        var typeResolver = new DefaultJsonTypeInfoResolver();
        typeResolver.Modifiers.Add(typeInfo =>
        {
            foreach (var prop in typeInfo.Properties)
            {
                // 查找属性上标记的DefaultValueAttribute
                if (prop.AttributeProvider?
                    .GetCustomAttributes(typeof(System.ComponentModel.DefaultValueAttribute), true)
                    .FirstOrDefault() is System.ComponentModel.DefaultValueAttribute attr)
                {
                    prop.DefaultValue = attr.Value;
                }
            }
        });
        options.JsonSerializerOptions.TypeInfoResolver = typeResolver;
    });

配置完成后，JSON请求体绑定场景下[DefaultValue]的行为就和早期JSON.NET的表现一致。

3. 实现自定义模型绑定器 #

如果需要实现更灵活的默认值逻辑（比如根据请求头、用户身份动态生成默认值，或者对某一类属性统一设置默认值规则），可以自定义IModelBinder实现对应逻辑，这种方案灵活度最高，但需要编写额外的绑定代码，仅适合复杂场景使用。

4. 切回JSON.NET作为默认JSON序列化器 #

如果项目依赖大量JSON.NET的专属特性，不想做适配改造，可以直接将默认序列化器换回Newtonsoft.Json：

• 引入NuGet包Microsoft.AspNetCore.Mvc.NewtonsoftJson
• 在Program.cs中修改服务注册代码：

builder.Services.AddControllers()
    .AddNewtonsoftJson();

配置完成后JSON反序列化行为会和.NET Core 2.x时期保持一致，[DefaultValue]特性默认生效。

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