ASP.NET Web API 2接收无效日期时如何提前抛出异常？

这个问题我之前踩过坑！默认的ASP.NET Web API日期处理确实有点反直觉——传个非日期字符串进去，它悄咪咪转成DateTime.MinValue就过去了，连个报错都没有，很容易埋下业务bug。先给你捋清楚为什么你的自定义ReadJson没触发，再给几个靠谱的解决方案：

为什么你的自定义DateTimeConverter没生效？ #

你提到继承了DateTimeConverterBase但ReadJson从未执行，大概率是这两个原因：

1. 默认转换器优先级更高：ASP.NET Web API 2默认用Newtonsoft.Json的IsoDateTimeConverter处理日期，它会先于你的自定义转换器执行，直接把非法字符串转成DateTime.MinValue。
2. 注册位置或顺序不对：如果你的转换器注册得太晚，或者没移除默认的日期转换器，就轮不到它处理。

最佳解决方案推荐 #

方案一：全局严格日期JsonConverter（最推荐） #

写一个严格的自定义JsonConverter，替换掉默认的日期转换器，这样所有DateTime/DateTime?参数都会经过校验，非法日期直接在模型绑定阶段抛异常。

首先创建转换器类：

public class StrictDateTimeConverter : JsonConverter
{
    // 可以根据你的业务需求调整日期格式
    private readonly string _expectedDateFormat = "yyyy-MM-ddTHH:mm:ss";

    public override bool CanConvert(Type objectType)
    {
        // 支持DateTime和可空DateTime
        return objectType == typeof(DateTime) || objectType == typeof(DateTime?);
    }

    public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer)
    {
        // 处理空值（针对可空DateTime）
        if (reader.TokenType == JsonToken.Null)
        {
            if (objectType == typeof(DateTime?))
                return null;
            throw new JsonSerializationException("非空日期参数不允许传null");
        }

        // 仅接受字符串类型的日期
        if (reader.TokenType != JsonToken.String)
        {
            throw new JsonSerializationException($"日期参数必须是字符串类型，当前类型：{reader.TokenType}");
        }

        var dateStr = reader.Value.ToString().Trim();
        if (!DateTime.TryParseExact(dateStr, _expectedDateFormat, CultureInfo.InvariantCulture, DateTimeStyles.None, out var validDate))
        {
            throw new JsonSerializationException($"日期格式错误，预期格式：{_expectedDateFormat}，实际传入：{dateStr}");
        }

        return validDate;
    }

    public override void WriteJson(JsonWriter writer, object value, JsonSerializer serializer)
    {
        // 序列化时统一格式
        if (value is DateTime date)
        {
            writer.WriteValue(date.ToString(_expectedDateFormat, CultureInfo.InvariantCulture));
        }
        else
        {
            writer.WriteNull();
        }
    }
}

然后在WebApiConfig.cs中注册（记得移除默认转换器）：

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 移除默认的IsoDateTimeConverter
        var defaultDateConverter = config.Formatters.JsonFormatter.SerializerSettings.Converters
            .FirstOrDefault(c => c is IsoDateTimeConverter);
        if (defaultDateConverter != null)
        {
            config.Formatters.JsonFormatter.SerializerSettings.Converters.Remove(defaultDateConverter);
        }

        // 添加我们的严格日期转换器
        config.Formatters.JsonFormatter.SerializerSettings.Converters.Add(new StrictDateTimeConverter());

        // 其他Web API配置路由、过滤器等...
        config.MapHttpAttributeRoutes();

        config.Routes.MapHttpRoute(
            name: "DefaultApi",
            routeTemplate: "api/{controller}/{id}",
            defaults: new { id = RouteParameter.Optional }
        );
    }
}

这样配置后，只要前端传非法日期字符串，Web API会直接返回400 Bad Request，并携带你定义的错误信息，不会让非法值进入控制器逻辑。

方案二：针对特定Action的参数验证过滤器 #

如果不想全局生效，只想给某些控制器/Action做校验，可以用ActionFilterAttribute：

public class ValidateValidDateTimeAttribute : ActionFilterAttribute
{
    private readonly string _paramName;

    public ValidateValidDateTimeAttribute(string paramName)
    {
        _paramName = paramName;
    }

    public override void OnActionExecuting(HttpActionContext actionContext)
    {
        if (!actionContext.ActionArguments.TryGetValue(_paramName, out var paramValue))
        {
            actionContext.Response = actionContext.Request.CreateErrorResponse(
                HttpStatusCode.BadRequest,
                $"缺少参数：{_paramName}");
            return;
        }

        // 检查是否是默认DateTime值（适用于非可空DateTime）
        if (paramValue is DateTime date && date == DateTime.MinValue)
        {
            actionContext.Response = actionContext.Request.CreateErrorResponse(
                HttpStatusCode.BadRequest,
                $"参数{_paramName}不是有效的日期");
        }
    }
}

使用时直接标记在Action上：

[HttpPost]
[ValidateValidDateTime("EventDate")]
public IHttpActionResult CreateEvent(EventModel model)
{
    // 正常业务逻辑
    return Ok();
}

⚠️ 注意：这个方案依赖DateTime.MinValue判断非法值，如果你的业务逻辑允许这个日期值，就不能用这个方法。

方案三：ViewModel自定义验证 #

如果是用ViewModel接收参数，也可以在ViewModel里实现IValidatableObject做自定义验证：

public class EventModel : IValidatableObject
{
    public DateTime EventDate { get; set; }

    public IEnumerable<ValidationResult> Validate(ValidationContext validationContext)
    {
        if (EventDate == DateTime.MinValue)
        {
            yield return new ValidationResult(
                "EventDate必须是有效的日期", 
                new[] { nameof(EventDate) });
        }
    }
}

然后在控制器里检查ModelState：

[HttpPost]
public IHttpActionResult CreateEvent(EventModel model)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }
    // 业务逻辑...
    return Ok();
}

这个方案适合单个ViewModel的局部校验，同样依赖DateTime.MinValue的判断逻辑。

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