ASP.NET MVC控制器方法为何接收空对象而非null值？

原因分析 #

ASP.NET MVC的模型绑定器对自定义复杂类型参数有默认行为：当控制器方法的参数是自定义类（如你的Area类）时，模型绑定器会自动实例化该类型的对象，不会让参数为null。即使请求中没有任何与Area属性匹配的参数，绑定器依然会创建一个Area实例，只是它的属性会被设置为对应类型的默认值（比如Id=0、Key=null）。这就是你得到“空Area对象”而非预期null的核心原因。

解决方案 #

方法1：改用简单类型参数（推荐） #

如果你的业务逻辑仅依赖Area.Id进行筛选，直接将参数替换为可空的简单类型，避免使用复杂类型：

public IActionResult Index(int? areaId)
{
    if (areaId == null)
    {
        return View(); // 无区域参数，展示所有员工
    }
    else
    {
        return View(areaId.Value); // 根据区域ID筛选展示
    }
}

前端传递区域ID时，只需给链接添加asp-route-areaId="123"即可；无参数时areaId会自动为null，符合你的预期。

方法2：检查模型绑定的有效数据 #

若必须保留Area作为参数，可通过ModelState判断是否有实际的绑定数据，区分“无参数传入”和“空属性的Area对象”：

public IActionResult Index(Area? area)
{
    // 检查是否存在与Area相关的绑定参数
    var hasAreaParams = ModelState.Keys.Any(key => key.StartsWith("Area."));
    if (!hasAreaParams)
    {
        return View(); // 无区域参数，展示所有员工
    }
    else
    {
        return View(area.Id);
    }
}

方法3：自定义模型绑定器 #

通过自定义模型绑定器，实现“无对应参数时返回null”的逻辑，适合有特殊绑定需求的场景：
首先定义自定义绑定器：

public class NullIfEmptyComplexTypeBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        // 无对应参数时直接返回null
        if (valueProviderResult == ValueProviderResult.None)
        {
            bindingContext.Result = ModelBindingResult.Success(null);
            return Task.CompletedTask;
        }
        // 有参数时使用默认复杂类型绑定逻辑
        var defaultBinder = new ComplexTypeModelBinder(
            bindingContext.ModelMetadata.Properties.ToDictionary(p => p.PropertyName)
        );
        return defaultBinder.BindModelAsync(bindingContext);
    }
}

然后在控制器参数上标记使用该绑定器：

public IActionResult Index(
    [ModelBinder(typeof(NullIfEmptyComplexTypeBinder))] 
    Area? area
)
{
    if (area == null)
    {
        return View();
    }
    else
    {
        return View(area.Id);
    }
}

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