ASP.NET Core WebAPI中[FromQuery]绑定DTO时[Required(AllowEmptyStrings = true)]失效及空字符串查询传参问题

嗨，我来帮你捋清楚这两个问题，这在ASP.NET Core的查询参数绑定里确实是个容易踩的小坑😉

问题1：如何让[Required(AllowEmptyStrings = true)]生效，或者把null值替换为空字符串？ #

核心原因是：ASP.NET Core默认的查询参数绑定逻辑里，像Details=这种空的查询值，会被绑定成null而不是空字符串""。而[Required(AllowEmptyStrings = true)]只认可空字符串是合法的，对null依然会判定为“必填项缺失”，所以才会报错。

给你两个简单有效的解决办法：

方法1：给DTO的字符串属性设置默认值

直接在DTO里把Details的默认值设为空字符串，这样就算绑定过来的是null，属性也会被初始化为""，验证就能通过了：

public class MyDTO
{
    [Required(AllowEmptyStrings = true), StringLength(50)]
    public string Details { get; set; } = string.Empty; // 这里添加默认值

    public int Value { get; set; }
}

方法2：全局配置模型绑定行为

如果你的项目里有很多类似场景，可以全局修改ASP.NET Core的绑定规则，让它把空的查询字符串值保留为空字符串，而不是转成null。在Program.cs（旧版本为Startup.cs）里添加以下配置：

builder.Services.AddControllers()
    .AddMvcOptions(options =>
    {
        options.ModelMetadataDetailsProviders.Add(new DisplayMetadataProvider(
            (context) =>
            {
                // 对所有string类型的属性，关闭“空字符串转null”的默认行为
                if (context.Key.ModelType == typeof(string))
                {
                    context.DisplayMetadata.ConvertEmptyStringToNull = false;
                }
            }));
    });

配置后，?Details=&value=100这样的请求会把Details绑定为空字符串，[Required(AllowEmptyStrings = true)]就能正常生效了。

问题2：为什么不能在URL查询字符串里传空字符串？ #

其实不是“不能传”，而是ASP.NET Core的默认模型绑定行为把空的查询值转换成了null。HTTP协议本身是允许查询参数存在但值为空的（比如Details=这种格式），但框架为了适配大部分场景，默认会把空字符串的查询值解析为null。

你可以理解为框架的一个默认约定，但这个约定是可以通过上面的全局配置修改的，修改后就能正常接收空字符串的查询参数了。

备注：内容来源于stack exchange，提问作者NajiMakhoul