ASP.NET Boilerplate 中 DateTime 字段序列化问题解析与解决方案

问题背景

在 ASP.NET Boilerplate 框架从 9.0 版本升级到 9.1 版本后，开发者遇到了 DateTime 字段序列化相关的两个主要问题：

1. DateTime 字段在 JSON 响应中自动追加了 "Z" 后缀（表示 UTC 时间），导致前端 Moment.js 处理时出现时间偏移
2. 在非英语语言环境下（如罗马尼亚语），日期绑定功能失效，出现 "The supplied value is invalid" 错误

问题分析

UTC 时间标识问题

在 9.0 版本升级后，DateTime 字段默认以 ISO 8601 格式序列化，自动添加 "Z" 后缀表示 UTC 时间。这导致：

• 前端 Moment.js 库会将 UTC 时间转换为本地时间，造成时间偏移
• 例如 "2024-01-26T13:45:00Z" 会被转换为本地时间（如 UTC+3 时区会变成 "2024-01-26T16:45:00"）

多语言环境下的日期解析问题

在非英语语言环境下，日期绑定功能失效，主要原因是：

• 新版本中日期解析器未能正确处理不同语言环境下的日期格式
• 特别是对于某些特定日期（如 2024 年 2 月 15 日）的解析会失败
• 使用英语语言环境时则工作正常

解决方案

临时解决方案

对于 UTC 时间问题，开发者可以：

1. 在前端处理时移除 "Z" 后缀
2. 或者显式指定 Moment.js 使用 UTC 模式解析

对于多语言环境问题，可以：

1. 回退到旧版本的 DateTime 序列化实现
2. 或者在配置中显式指定日期格式

services.AddControllersWithViews()
    .AddNewtonsoftJson(options => {
        options.SerializerSettings.ContractResolver = new AbpMvcContractResolver(
            new List<string> {
                CultureInfo.CurrentCulture.DateTimeFormat.ShortDatePattern,
                CultureInfo.CurrentCulture.DateTimeFormat.ShortTimePattern,
                // 其他需要的格式
            }, 
            CultureInfo.CurrentCulture.DateTimeFormat.SortableDateTimePattern)
        {
            NamingStrategy = new CamelCaseNamingStrategy()
        };
    });

官方修复方案

ASP.NET Boilerplate 团队已经通过代码提交修复了这些问题：

1. 改进了 DateTime 序列化处理，确保在不同语言环境下正常工作
2. 提供了通过 IAbpAspNetCoreConfiguration 的 InputDateTimeFormats 配置日期格式的能力

最佳实践建议

1. 对于时间处理：

   • 前后端统一使用 UTC 时间，避免时区转换问题
   • 在前端显示时再进行本地化转换

2. 对于多语言支持：

   • 测试应用在所有支持语言环境下的日期处理
   • 考虑使用固定格式（如 ISO 8601）进行传输

3. 升级注意事项：

   • 升级前测试日期相关功能
   • 准备好回滚方案

总结

DateTime 处理是国际化应用中的常见痛点，ASP.NET Boilerplate 框架在不断改进其日期时间处理机制。开发者应当理解时间序列化的基本原理，并在应用中建立统一的时间处理策略，以确保跨版本和跨语言环境下的稳定性。