ASP.NET Core中向控制器端点传递Null复杂类型的更佳方案探讨

方案1：通用化自定义模型绑定器（替代现有硬编码实现） #

现有实现仅针对BreakSize类型，可修改为通用版本，支持所有复杂类型，同时复用内置模型绑定逻辑，避免手动赋值的麻烦：

public class NullableComplexModelBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        if (context == null)
            throw new ArgumentNullException(nameof(context));

        // 只处理非值类型（复杂类型）且允许为null的情况
        if (!context.Metadata.IsValueType && context.Metadata.IsNullableValueType == false)
        {
            // 获取内置模型绑定器，用于处理正常非空场景
            var innerBinder = context.CreateBinder(context.Metadata);
            return new NullableComplexModelBinder(innerBinder);
        }

        return null;
    }
}

public class NullableComplexModelBinder : IModelBinder
{
    private readonly IModelBinder _innerBinder;

    public NullableComplexModelBinder(IModelBinder innerBinder)
    {
        _innerBinder = innerBinder ?? throw new ArgumentNullException(nameof(innerBinder));
    }

    public async Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
            throw new ArgumentNullException(nameof(bindingContext));

        // 检查请求中是否存在当前字段，且值为空字符串
        var fieldValue = bindingContext.ValueProvider.GetValue(bindingContext.FieldName);
        if (fieldValue != ValueProviderResult.None && string.IsNullOrEmpty(fieldValue.FirstValue))
        {
            bindingContext.Result = ModelBindingResult.Success(null);
            return;
        }

        // 非空场景，复用内置绑定器完成模型赋值
        await _innerBinder.BindModelAsync(bindingContext);
    }
}

注册方式（Program.cs或Startup.cs）：

builder.Services.AddControllers(options =>
{
    // 将自定义提供器插入绑定器链最前端
    options.ModelBinderProviders.Insert(0, new NullableComplexModelBinderProvider());
});

该方案优势：

• 无需为每个复杂类型单独配置
• 复用内置绑定逻辑，不用手动处理属性赋值
• 全局生效，所有符合条件的复杂类型自动处理空值为null

方案2：使用类型转换器（TypeConverter） #

为目标复杂类型实现TypeConverter，让模型绑定系统遇到空字符串时自动返回null：

[TypeConverter(typeof(BreakSizeConverter))]
public class BreakSize
{
    // 模型属性示例
    public int Hours { get; set; }
    public int Minutes { get; set; }
}

public class BreakSizeConverter : TypeConverter
{
    public override bool CanConvertFrom(ITypeDescriptorContext context, Type sourceType)
    {
        return sourceType == typeof(string) || base.CanConvertFrom(context, sourceType);
    }

    public override object ConvertFrom(ITypeDescriptorContext context, CultureInfo culture, object value)
    {
        var stringValue = value as string;
        if (string.IsNullOrEmpty(stringValue))
            return null;

        // 可选：实现非空字符串到模型的转换逻辑（如解析格式字符串）
        var parts = stringValue.Split(',');
        if (parts.Length == 2 && int.TryParse(parts[0], out int hours) && int.TryParse(parts[1], out int minutes))
        {
            return new BreakSize { Hours = hours, Minutes = minutes };
        }

        return base.ConvertFrom(context, culture, value);
    }
}

该方案优势：

• 针对单个类型配置，适合无需全局生效的场景
• 逻辑集中在转换器，与模型绑定系统解耦

方案3：结合Nullable引用类型（C# 8.0+） #

若项目启用了Nullable引用类型（.csproj中设置<Nullable>enable</Nullable>），可通过配置让框架自动处理空值：

builder.Services.AddControllers(options =>
{
    options.ModelBindingMessageProvider.SetValueMustNotBeNullAccessor(
        _ => "值不能为空");
})
.AddMvcOptions(options =>
{
    // 配置当引用类型模型的所有属性为空时，绑定为null
    options.ModelMetadataDetailsProviders.Add(new SuppressChildValidationMetadataProvider(typeof(BreakSize)));
});

注意：该方案要求请求中未传递任何模型属性值，框架才会绑定为null；若传递了空字符串属性值，需结合前面的方案补充处理。

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