如何构建可接收空日期参数的C# GET API端点？

三种方案的优劣分析 #

• 方案一：使用DateTime类型参数
  代码示例：

  [HttpGet("Accounts/Statements/filter")]
  public async Task<IActionResult> GetStatementsFilter(DateTime startDate, DateTime endDate)
  

  问题：前端传入startdate=null时，模型绑定会将其解析为DateTime的默认值01/01/0001，无法区分“用户传入null”和“用户未传参”的场景，极易导致业务逻辑判断错误。

• 方案二：使用string类型参数
  代码示例：

  [HttpGet("Accounts/Statements/filter")]
  public async Task<IActionResult> GetStatementsFilter(string startDate, string endDate)
  

  优势：能准确接收前端传入的"null"字符串，后续可手动处理：判断字符串是否为"null"，若是则视为逻辑上的null，否则通过DateTime.TryParse或DateTime.TryParseExact安全转换为日期对象。该方案无需修改前端现有传参逻辑，适配性强。
  注意点：需自行处理无效日期格式的异常情况，避免转换失败抛出错误。

• 方案三：使用[FromBody]接收实体类
  代码示例：

  [HttpGet("Accounts/Statements/filter")]
  public async Task<IActionResult> GetStatementsFilter([FromBody] DateObj dateObj)
  

  问题：GET请求携带请求体不符合HTTP规范，多数HTTP客户端和服务器对这种场景存在兼容性问题，且需要前端大幅修改传参方式，改造成本高，不推荐使用。

最佳选择 #

优先选择方案二；若希望兼顾强类型参数的便捷性，可自定义模型绑定器，让DateTime?类型直接支持解析"null"字符串，无需手动处理字符串转换：

自定义模型绑定器示例 #

public class NullableDateTimeBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
        {
            return Task.CompletedTask;
        }

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);

        string value = valueProviderResult.FirstValue;
        if (string.Equals(value, "null", StringComparison.OrdinalIgnoreCase))
        {
            bindingContext.Result = ModelBindingResult.Success(null);
            return Task.CompletedTask;
        }

        if (DateTime.TryParse(value, out DateTime dateTime))
        {
            bindingContext.Result = ModelBindingResult.Success(dateTime);
            return Task.CompletedTask;
        }

        bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, "无效的日期格式");
        return Task.CompletedTask;
    }
}

使用绑定器的API端点示例 #

[HttpGet("Accounts/Statements/filter")]
public async Task<IActionResult> GetStatementsFilter(
    [ModelBinder(typeof(NullableDateTimeBinder))] DateTime? startDate, 
    DateTime endDate)

该方案既保留了强类型参数的优势，又能正确处理前端传入的"null"字符串，同时无需前端修改请求格式。

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