ASP.NET Core 中 Minimal API 对日期时间类型的验证问题解析

在 ASP.NET Core 的 Minimal API 开发中，开发者可能会遇到一个关于日期时间类型验证的特殊问题。当请求体包含 DateTimeOffset、DateOnly 或 TimeOnly 类型的属性时，系统会抛出验证异常，而同样的代码结构使用 DateTime 类型却能正常工作。

问题现象

当开发者启用 Minimal API 的验证功能后，如果请求体模型包含上述日期时间类型的属性，系统会报出"Maximum validation depth of 32 exceeded"的错误。错误信息显示验证系统陷入了对 Now 属性的无限递归验证中，最终触发了最大验证深度限制。

技术背景

这个问题的根源在于 ASP.NET Core 的验证系统实现机制。验证系统会递归地检查对象图中的所有属性，但对于某些特殊类型（如 DateTimeOffset）的静态属性 Now，验证系统错误地将其纳入了验证范围，导致了验证循环。

解决方案分析

目前 ASP.NET Core 团队已经确认这是一个已知问题，并将其标记为与另一个验证相关问题相同。核心解决方案将涉及以下几个方面：

1. 验证系统需要忽略静态属性的验证
2. 需要重用 Minimal API 源生成器中已有的可解析类型检测逻辑
3. 可能需要改进验证上下文中的对象图遍历机制

临时解决方案

在官方修复发布前，开发者可以采取以下临时措施：

1. 暂时禁用验证功能（不推荐长期方案）
2. 使用自定义验证逻辑替代系统验证
3. 在模型中使用 DateTime 类型替代问题类型（如有可行性）

技术深度解析

这个问题揭示了验证系统在处理特殊类型时的设计缺陷。理想的验证系统应该：

1. 能够识别并跳过静态属性
2. 具备检测循环引用的能力
3. 对内置特殊类型有特殊处理逻辑
4. 提供更灵活的验证深度控制

总结

这个问题虽然表现为日期时间类型的验证异常，但本质上反映了验证系统在对象图遍历和特殊类型处理方面的不足。ASP.NET Core 团队已经将其纳入修复计划，开发者可以关注后续版本更新获取官方修复。在等待修复期间，开发者应了解问题本质，并根据项目需求选择合适的临时解决方案。