MoneyManagerEx桌面版中实现INT64和SUID支持的技术方案

背景与需求分析

在MoneyManagerEx桌面版(MMEX4Desktop)的开发过程中，团队面临着一个重要的技术挑战：如何改进数据库中的ID生成机制以提高数据同步和冲突解决能力。传统自增整数ID在分布式环境或数据合并场景下容易产生冲突，这限制了应用的扩展性和数据同步能力。

技术方案设计

SUID机制介绍

SUID(Sequential Unique ID)是一种结合时间戳和随机数的ID生成方案，其核心设计思想是：

1. 使用毫秒级时间戳作为基础
2. 附加3位随机数作为补充
3. 组合形成64位整数ID

这种设计使得ID在分布式环境中几乎不会发生冲突，同时保持了时间有序性。例如一个Payee实体的SUID可能形如：1731396158462442。

数据库层改造

为了实现这一方案，需要对MoneyManagerEx的数据库层进行以下改造：

1. 将原有32位整数ID升级为64位整数
2. 修改SQLite3接口以支持64位整数操作
3. 重构数据访问层以处理新的ID类型

关键技术点包括：

• 使用wxLongLong作为跨平台的64位整数表示
• 替换原有的GetInt操作为GetInt64
• 创建wxArrayInt64类型替代原有的wxArrayInt

代码实现示例

以TAG_V1表为例，插入操作的改造如下：

if (entity->id() <= 0) // 新记录插入
{
    sql = "INSERT INTO TAG_V1(TAGNAME, ACTIVE, TAGID) VALUES(?, ?, ?)";
    stmt.Bind(3, SUID()); // 使用SUID替代自增ID
}
else
{
    sql = "UPDATE TAG_V1 SET TAGNAME = ?, ACTIVE = ? WHERE TAGID = ?";
}

技术挑战与解决方案

并发环境下的ID冲突

尽管SUID冲突概率极低，但在高并发批量插入场景下仍需考虑：

1. 实现重试机制：当检测到ID冲突时自动延迟重试
2. 设置重试上限：避免无限重试导致的死锁
3. 回退机制：最终可回退到SQLite自动生成的ROWID

数据类型兼容性

确保64位整数在整个应用栈中的兼容性：

1. JSON序列化/反序列化支持64位整数
2. 界面层正确处理64位数值显示
3. 数据库迁移脚本兼容新旧ID格式

应用价值

这一技术改进为MoneyManagerEx带来了显著优势：

1. 可靠的数据同步：支持从文件级到行级的细粒度同步
2. 强大的合并能力：实现完整和部分数据导入的无缝合并
3. 未来扩展性：为分布式使用场景奠定基础
4. 冲突解决：极大降低了数据合并时的ID冲突概率

实施建议

对于开发者实施此类改造，建议：

1. 分阶段进行，先完成基础数据类型升级
2. 建立完善的测试用例验证ID生成唯一性
3. 考虑添加迁移工具处理旧数据库升级
4. 文档记录ID生成规则以便其他模块集成

这一技术升级使MoneyManagerEx在数据管理能力上迈上了新台阶，为未来的功能扩展和性能优化打下了坚实基础。