Asp.Net Core 2.2中GET请求DTO始终非空，期望无参时为null的技术咨询

这问题我太熟了！在Asp.Net Core里，当你用[FromQuery]绑定复杂类型DTO时，框架只要检测到DTO有公共无参构造函数，就会自动实例化它——哪怕你一个查询参数都没传，这就是为什么你的request永远不会为null的原因，[CanBeNull]注解只是做代码提示，不会改变这个绑定逻辑。

下面给你几个可行的解决方案，你可以根据自己的场景选择：

方案一：检查DTO属性是否为默认值（最简单） #

既然框架一定会实例化DTO，那我们可以通过判断所有属性是否都是默认值（也就是你构造函数里设置的初始值），来区分“无查询参数”和“有参数传入”的情况。

首先给DTO加一个扩展方法，用来判断是否为空：

public static class SearchQueryDtoExtensions
{
    public static bool IsEmpty(this SearchQueryDto dto)
    {
        // 对照你构造函数里的默认值和属性初始状态来判断
        return string.IsNullOrEmpty(dto.Query) &&
               string.IsNullOrEmpty(dto.PhoneNumber) &&
               string.IsNullOrEmpty(dto.ClassificationId) &&
               dto.Offset == 0 &&
               dto.Limit == 10;
    }
}

然后修改你的端点代码：

[HttpGet]
public async Task<IActionResult> GetAllRecords([FromQuery] SearchQueryDto request)
{
    if (!request.IsEmpty())
    {
        return Ok(await _service.Search(request));
    }
    return Ok(await _service.GetAll());
}

这个方案的优点是代码改动最小，适合属性不多的DTO。

方案二：改用单个可选查询参数（直观） #

如果你的DTO属性不多，可以直接把每个查询参数作为方法的可选参数，然后手动判断是否有参数传入，再构建DTO：

[HttpGet]
public async Task<IActionResult> GetAllRecords(
    [FromQuery] string query = null,
    [FromQuery] string phoneNumber = null,
    [FromQuery] string classificationId = null,
    [FromQuery] int offset = 0,
    [FromQuery] int limit = 10)
{
    // 只要有一个参数不是默认值，就走搜索逻辑
    if (query != null || phoneNumber != null || classificationId != null || offset != 0 || limit != 10)
    {
        var request = new SearchQueryDto
        {
            Query = query,
            PhoneNumber = phoneNumber,
            ClassificationId = classificationId,
            Offset = offset,
            Limit = limit
        };
        return Ok(await _service.Search(request));
    }
    return Ok(await _service.GetAll());
}

这个方案的好处是逻辑直观，不需要修改DTO，但如果DTO属性很多，方法签名会变得很长。

方案三：自定义模型绑定器（最灵活） #

如果想要严格实现“无参数时返回null”的效果，可以自定义一个模型绑定器，让它在没有查询参数时返回null，否则正常绑定DTO。

首先创建模型绑定器类：

public class SearchQueryDtoModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var queryParams = bindingContext.HttpContext.Request.Query;
        
        // 检查是否有任何匹配DTO属性的查询参数
        var hasAnyValidParam = queryParams.ContainsKey("query") ||
                               queryParams.ContainsKey("phoneNumber") ||
                               queryParams.ContainsKey("classificationId") ||
                               queryParams.ContainsKey("offset") ||
                               queryParams.ContainsKey("limit");
        
        if (!hasAnyValidParam)
        {
            // 没有参数时返回null
            bindingContext.Result = ModelBindingResult.Success(null);
            return Task.CompletedTask;
        }
        
        // 有参数时用默认的复杂类型绑定器处理
        var defaultBinder = new ComplexTypeModelBinder(new Dictionary<ModelMetadata, IModelBinder>());
        return defaultBinder.BindModelAsync(bindingContext);
    }
}

然后在你的DTO上标注使用这个绑定器：

[ModelBinder(BinderType = typeof(SearchQueryDtoModelBinder))]
public sealed class SearchQueryDto {
    public SearchQueryDto() {
        Limit = 10;
        Offset = 0;
    }
    public string Query { get; set; }
    public string PhoneNumber { get; set; }
    public string ClassificationId { get; set; }
    public int Offset { get; set; }
    public int Limit { get; set; }
}

最后你的端点代码就可以回到原来的逻辑了：

[HttpGet]
public async Task<IActionResult> GetAllRecords([FromQuery] [CanBeNull] SearchQueryDto request) {
    if (request != null)
    {
        return Ok(await _service.Search(request));
    }
    return Ok(await _service.GetAll());
}

这个方案最灵活，适合复杂场景，但需要额外写绑定器代码，稍微麻烦一点。

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