Blossom项目中的计划日期保存异常问题分析与解决

问题现象

在使用Blossom项目v1.16.0版本时，用户发现了一个关于计划(plan)功能的日期保存异常问题。具体表现为：当用户创建一个计划并设置日期时间(例如2024-04-25 09:00:00至2024-04-25 18:00:00)后，保存后日期会意外地变为前一天(2024-04-24 09:00:00至2024-04-24 18:00:00)。

问题分析

这种日期偏移问题在软件开发中通常与时区配置有关。Blossom项目采用了客户端-服务器架构，客户端运行在Windows 11系统上，而服务器端则是通过Docker部署在Linux系统上。经过排查，发现系统时区设置本身是正确的(东八区/CST)，但问题出在数据库连接配置上。

根本原因

问题的根源在于MySQL数据库连接的时区配置。在示例配置中使用了serverTimezone=GMT参数，这表示连接时使用格林尼治标准时间(UTC+0)作为时区。当客户端(东八区)发送本地时间到服务器时，服务器会将其视为GMT时间，而保存到数据库时又会根据服务器时区(东八区)进行转换，导致时间出现了8小时的偏差，最终表现为日期"回退"了一天。

解决方案

针对这个问题，正确的解决方法是修改MySQL连接字符串中的时区参数，将其设置为与服务器实际时区一致的Asia/Shanghai(东八区)。这样就能确保时间在客户端、服务器和数据库之间传递时保持一致。

技术背景

在分布式系统中，时间处理是一个常见但容易出错的环节。主要涉及以下几个关键点：

1. 客户端时区：用户操作界面所在的设备时区
2. 服务器时区：应用服务器运行环境的时区
3. 数据库时区：数据库服务器配置的时区
4. 连接时区：应用程序连接数据库时指定的时区参数

当这些时区设置不一致时，就可能导致时间数据的意外转换和偏移。最佳实践是确保整个系统栈使用统一的时区配置，或者在时间传递时明确标注时区信息。

预防措施

为了避免类似问题，建议开发者在部署Blossom项目时：

1. 检查并统一系统各层的时区设置
2. 确保数据库连接字符串中的时区参数与实际时区一致
3. 在开发环境中模拟不同时区的场景进行测试
4. 考虑在时间数据存储时使用UTC时间，仅在展示时转换为本地时间

通过以上措施，可以有效避免因时区问题导致的各种时间相关异常。