ASP.NET API可选参数未被识别，请求返回400 Bad Request错误

安全阿岳

2026-8-15

ASP.NET API 可选参数空值触发必填错误的解决方案

问题根源

ASP.NET Core模型绑定默认会将?notes=这类空字符串请求参数判定为"缺失有效值"，即便你给参数设置了默认值，只要参数未显式允许null，就会触发The notes field is required的400错误。

具体解决步骤

显式允许参数为可空类型
如果你用的是C# 8+的可空引用类型，直接给参数加上?标记，同时保留默认值：
```
[HttpPost("Update")]
public IActionResult Update(string? notes = "")
{
    // 业务逻辑
    return Ok();
}
```
这样无论是不传notes参数（使用默认空字符串），还是传?notes=（绑定为空字符串），都不会触发必填校验。
显式指定Query绑定并允许空值
若需要更明确的绑定规则，可使用[FromQuery]特性显式声明参数来源，同时标记为可空：
```
[HttpPost("Update")]
public IActionResult Update([FromQuery(Name = "notes")] string? notes = "")
{
    return Ok();
}
```
检查项目可空引用类型配置
打开项目的.csproj文件，查看是否启用了<Nullable>enable</Nullable>。如果启用了，所有未标记?的引用类型参数都会被视为非空，此时必须给可选参数加上?才能接受空值。

全局配置空字符串处理（可选）
如果需要全局统一处理空字符串为null，可在Program.cs中添加模型绑定配置：

builder.Services.AddControllers(options =>
{
    // 自定义必填错误提示（可选）
    options.ModelBindingMessageProvider.SetValueMustNotBeNullAccessor(
        _ => "该字段不能为空");
});