Mealie 项目中的多用户数据迁移与合并策略

背景介绍

Mealie 是一款开源的食谱管理应用，在 v2 版本中引入了"家庭(Household)"这一新概念，允许在同一组(Group)下创建多个家庭单位，从而更灵活地管理食谱共享。这一架构变更给从 v1 升级的用户带来了数据迁移的挑战，特别是那些原本使用多个组来区分不同用户数据的场景。

迁移挑战分析

在 Mealie v1 中，许多用户习惯为每个家庭成员创建单独的组(Group)，这导致升级到 v2 后存在以下问题：

1. 组间数据隔离性强，无法直接合并
2. 用户无法通过界面直接迁移到其他组
3. 食谱数据与组绑定，迁移时容易丢失关联关系
4. 分类、标签等元数据也存在组间隔离

解决方案概述

针对上述挑战，我们提供两种可行的数据迁移方案：通过界面操作的标准迁移方法和直接操作数据库的高级方法。两种方法各有优缺点，用户可根据自身技术能力选择。

方案一：界面操作迁移法

操作步骤

1. 准备工作

   • 备份整个 Mealie 实例
   • 记录现有组和用户结构

2. 数据导出

   • 从每个组中导出所有食谱为 ZIP 文件
   • 建议按组分别导出

3. 目标组准备

   • 创建或选择一个主组作为目标
   • 在该组下创建所需的家庭单位

4. 数据导入

   • 登录目标组管理员账户
   • 逐个导入之前导出的食谱 ZIP 文件
   • 注意：需先删除原组中的食谱才能成功导入

5. 用户迁移

   • 在原组中删除所有食谱
   • 删除原用户
   • 在目标组中重新创建用户并分配到对应家庭

6. 数据归属处理

   • 使用食谱数据管理页面批量修改食谱所有者
   • 可通过"添加日期"筛选新导入的食谱

注意事项

• 此方法会丢失部分解析数据
• 分类和标签需要手动重建
• 操作顺序至关重要：食谱→用户→家庭→组

方案二：数据库直接操作法

前置要求

• 熟悉 SQL 基本操作
• 了解数据库风险
• 已做好完整备份

详细步骤

1. 组信息确认

   SELECT * FROM groups;
   

2. 食谱迁移

   UPDATE recipes
   SET group_id='目标组ID'
   WHERE group_id='原组ID';
   

3. 用户迁移

   UPDATE users
   SET group_id = '目标组ID',
       household_id = '目标家庭ID'
   WHERE id = '用户ID';
   

4. 元数据合并(可选)

   • 分类迁移：

   UPDATE categories
   SET group_id = '目标组ID'
   WHERE group_id = '原组ID';
   

   • 标签迁移：

   UPDATE tags
   SET group_id = '目标组ID'
   WHERE group_id = '原组ID';
   

风险提示

• 操作不当可能导致数据不一致
• 必须严格按照顺序执行
• 迁移后需全面验证数据完整性

方案对比与选择建议

方案	优点	缺点	适用场景
界面操作	无需技术背景，安全性高	步骤繁琐，会丢失部分数据	少量数据迁移，技术能力有限的用户
数据库操作	保留完整数据，效率高	技术要求高，风险较大	大批量数据迁移，有数据库管理经验的用户

最佳实践建议

1. 全面备份：无论采用哪种方案，都必须先备份数据库和应用数据
2. 分步验证：每完成一个关键步骤就验证数据状态
3. 非关键数据重建：考虑重新创建食品、单位等基础数据而非迁移
4. 灰度迁移：先在小规模测试环境验证方案可行性
5. 文档记录：详细记录操作步骤，便于问题排查

总结

Mealie v2 的家庭功能为多用户协作提供了更优雅的解决方案，但数据迁移需要谨慎处理。本文提供的两种方案各有优势，用户应根据自身情况选择。对于大多数用户，推荐优先尝试界面操作方案，虽然步骤较多但风险可控。对于有技术能力的用户，数据库直接操作可以更完整地保留数据关系。无论采用哪种方法，充分的准备和验证都是成功迁移的关键。