Json.NET反序列化无时区的DateTimeOffset.MinValue失败解决方案

这个问题的根源很明确：你所在的时区是UTC+2，Json.NET默认会把无时区的DateTime字符串转换为本地时区的DateTimeOffset。当你传入0001-01-01T00:00:00时，它会被转成0001-01-01T00:00:00+02:00，但DateTimeOffset的最小值是0001-01-01T00:00:00+00:00，这个转换后的时间早于最小值，直接触发溢出报错。

因为不能修改调用方代码，我们可以在API端通过两种方式解决：

方案1：全局设置无时区日期默认按UTC解析 #

这是最简单的解决方案，适合你的API所有无时区日期都应该以UTC处理的场景。只需要在Json.NET的配置中修改DateTimeZoneHandling为Utc，这样0001-01-01T00:00:00会被直接解析为DateTimeOffset.MinValue（正好是UTC的最小时间），不会触发溢出。

配置代码（.NET Core/.NET 6+） #

在Program.cs或Startup.cs中配置：

services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        // 设置无时区日期默认解析为UTC
        options.SerializerSettings.DateTimeZoneHandling = DateTimeZoneHandling.Utc;
    });

方案2：自定义JsonConverter精准处理最小日期 #

如果你不想全局修改时区处理规则，只想针对0001-01-01T00:00:00这个特殊值做处理，可以写一个自定义转换器。这种方式更灵活，还能根据业务需求把这个值映射为null（如果调用方用它表示“无日期”）。

自定义转换器代码 #

public class DateTimeOffsetMinValueConverter : JsonConverter<DateTimeOffset?>
{
    public override DateTimeOffset? ReadJson(JsonReader reader, Type objectType, DateTimeOffset? existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        if (reader.TokenType == JsonToken.String)
        {
            var dateString = reader.Value.ToString();
            
            // 检测是否是目标特殊日期
            if (dateString.Equals("0001-01-01T00:00:00", StringComparison.OrdinalIgnoreCase))
            {
                // 可选：如果业务上这个值代表"无日期"，返回null
                // return null;
                
                // 或者返回UTC的最小DateTimeOffset
                return DateTimeOffset.MinValue;
            }

            // 正常解析其他日期（按UTC处理，也可以改成本地时区）
            if (DateTimeOffset.TryParse(dateString, CultureInfo.InvariantCulture, DateTimeStyles.AssumeUniversal, out var result))
            {
                return result;
            }
        }

        // 其他情况用默认序列化逻辑
        return serializer.Deserialize<DateTimeOffset?>(reader);
    }

    public override void WriteJson(JsonWriter writer, DateTimeOffset? value, JsonSerializer serializer)
    {
        // 序列化时如果是MinValue，返回调用方预期的格式
        if (value.HasValue && value.Value == DateTimeOffset.MinValue)
        {
            writer.WriteValue("0001-01-01T00:00:00");
        }
        else
        {
            serializer.Serialize(writer, value);
        }
    }
}

注册转换器 #

全局注册

和方案1一样，在Json配置中添加转换器：

services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        options.SerializerSettings.Converters.Add(new DateTimeOffsetMinValueConverter());
    });

仅针对单个属性注册

如果只想处理特定属性，直接在属性上标记：

[JsonProperty("revisedDate", NullValueHandling = NullValueHandling.Ignore)]
[JsonConverter(typeof(DateTimeOffsetMinValueConverter))]
public DateTimeOffset? RevisedDate { get; set; }

选择建议 #

• 如果你的API所有无时区日期都应该按UTC解析，优先用方案1，代码最少，维护成本低。
• 如果只有0001-01-01T00:00:00这个特殊值需要处理，或者业务上它代表“无日期”，用方案2更精准。

内容的提问来源于stack exchange，提问作者René Schindhelm