CryptPad日历功能中年度重复事件的月份显示错误问题分析

问题概述

在CryptPad的日历功能中，当用户在2月份创建年度重复事件时，系统会在每月30日错误地将事件月份显示为3月而非2月。该问题表现为事件编辑弹窗中显示的文本与实际设置不符，例如系统会错误显示"Every 1 year(s) on the first Monday of March"。

技术背景

CryptPad是一个注重隐私保护的在线协作平台，其日历功能支持创建重复事件，包括每日、每周、每月和每年重复模式。年度重复事件的实现依赖于JavaScript的日期处理逻辑，特别是对月份的处理。

问题根源分析

经过技术分析，该问题源于JavaScript Date对象在处理2月日期时的特殊行为：

1. 当系统日期为某月30日时，尝试创建2月29日的Date对象会导致自动溢出到下个月(3月)
2. CryptPad的重复事件文本生成逻辑没有正确处理这种日期溢出情况
3. 系统直接从当前Date对象获取月份名称，而没有参考原始事件设置

解决方案

修复该问题需要改进日期处理逻辑：

1. 存储原始事件设置的月份信息，不依赖运行时Date对象
2. 在处理2月日期时添加检查机制
3. 当日期溢出时回退到2月最后一天(28日或29日)而不是允许自动溢出

实现细节

在技术实现上，修复方案需要：

1. 修改事件对象的序列化方式，确保原始月份信息被保留
2. 重写日期显示逻辑，优先使用存储的月份而非计算出的月份
3. 添加单元测试覆盖2月特殊情况

影响范围

该问题影响所有使用年度重复事件功能的用户，特别是在2月设置事件的场景。虽然功能上事件仍会正确触发，但显示错误可能造成用户混淆。

最佳实践建议

对于开发者处理日历功能时：

1. 始终明确区分"显示月份"和"计算月份"
2. 对2月进行特殊处理，考虑闰年情况
3. 实现完整的测试机制，包括每月30/31日场景
4. 在UI中保持原始设置信息的可见性

总结

CryptPad日历中的这一显示问题展示了日期处理在Web应用中的常见挑战。通过这次修复，不仅解决了特定问题，也为类似功能的稳健实现提供了参考模式。正确处理日期特殊情况对于日历类应用至关重要，开发者应当给予特别关注。