Wakapi项目中的编辑器时间统计错误问题分析与修复

问题背景

Wakapi是一款开源的时间追踪工具，用于记录开发者在各种编辑器、项目和语言上花费的时间。在2.10.4版本中，用户报告了一个严重的统计数据显示错误：在全局摘要页面显示的编辑器时间明显低于实际使用时间，而进入具体项目页面后，同一编辑器的统计时间却显示正常。

问题现象

多位用户报告了类似的异常现象：

1. 主页面显示的编辑器使用时间异常偏低
2. 具体项目页面显示同一编辑器的使用时间更高
3. 语言、操作系统和机器等统计项也出现类似问题
4. 使用&recompute=true参数后统计数据恢复正常

技术分析

经过开发团队深入排查，发现问题根源在于数据库持久化层的变更。具体原因如下：

1. 在791f5cc提交中，移除了部分外键约束并添加了gorm:"-"标签，目的是防止GORM创建不必要的外键
2. 这一变更导致除项目类型外的其他统计项（编辑器、语言、操作系统和机器）无法正确持久化到数据库
3. 数据库中的SummaryItem记录类型全部变为0（代表项目类型）
4. 当不使用recompute参数时，系统从数据库读取这些不完整的统计数据，导致显示错误
5. 使用recompute参数时，系统实时计算数据，绕过了数据库问题，因此显示正确

解决方案

开发团队迅速响应并提出了修复方案：

1. 修改持久化逻辑，确保所有类型的统计项都能正确保存到数据库
2. 特别处理编辑器、语言、操作系统和机器等统计项的存储
3. 保持项目统计项的外键约束不变（因其原本工作正常）

用户应对措施

对于遇到此问题的用户，建议采取以下步骤：

1. 升级到包含修复的版本
2. 进入设置中的"危险区域"
3. 执行"重新生成摘要"操作
4. 等待摘要重新计算完成（可能需要较长时间，取决于数据量）

技术启示

这一问题为我们提供了几个重要的技术经验：

1. 数据库模式变更需要全面测试所有相关功能
2. ORM标签的使用需谨慎，特别是可能影响持久化的标签
3. 统计类功能应同时测试缓存数据和实时计算数据的一致性
4. 复杂系统的数据一致性验证非常重要

总结

Wakapi团队快速响应并修复了这个影响核心功能的统计显示问题。通过分析数据库持久化层的问题根源，开发人员不仅解决了当前问题，也为未来的类似功能开发积累了宝贵经验。用户只需按照建议升级并重新生成摘要，即可恢复正常使用。