Immich-go项目中的Google相册专辑导入问题分析与解决方案

问题背景

在使用immich-go工具从Google相册导入照片到Immich平台时，用户遇到了专辑标签丢失的问题。具体表现为：部分照片未被正确分配到专辑中，专辑照片数量统计不准确，以及重复照片处理不当等情况。

问题现象

1. 专辑标签丢失：部分照片虽然在Google相册中被分配到多个专辑，但在导入Immich后却完全丢失了专辑信息。
2. 数量统计差异：专辑中的照片数量显示不准确，通常比实际数量少。
3. 重复照片问题：系统检测到重复照片，但处理方式不够理想。
4. 特殊类型文件问题：连拍照片(Burst)、动态照片(Motion)和共享专辑中的照片更容易出现专辑分配失败的情况。

技术分析

经过深入分析，我们发现这些问题主要由以下几个技术因素导致：

1. Google Takeout导出不完整：Google提供的导出文件中，某些照片的JSON元数据文件与其对应的图片文件不在同一个压缩包中，导致immich-go无法正确关联。

2. 重复照片处理机制：当Immich中已存在同名、同日期但不同大小的照片时，系统会将其标记为重复并放入回收站，但专辑关联信息可能丢失。

3. 特殊文件类型支持：动态照片和连拍照片的处理逻辑需要特别优化，目前这些类型的照片更容易出现专辑分配问题。

4. 共享专辑导出限制：Google Takeout对共享专辑的导出存在限制，导致部分照片无法完整导出。

解决方案

针对上述问题，我们建议采取以下解决方案：

1. 全新导入策略：

   • 清空现有Immich实例中的所有照片和专辑
   • 从Google相册申请全新的Takeout导出
   • 使用immich-go upload from-google-photos命令而非from-folder命令进行导入

2. 优化Takeout导出设置：

   • 申请按专辑分开的Takeout导出
   • 请求更大的存档块大小，减少文件分散在不同压缩包的情况

3. 导入参数调整：

   • 使用--log-level=DEBUG和--api-trace参数获取详细日志
   • 定期清空Immich的回收站，避免重复照片干扰

4. 特殊文件处理：

   • 对于动态照片和连拍照片，建议单独导出并验证
   • 共享专辑建议单独处理，或直接在Immich中重建

最佳实践建议

1. 分批次导入：不要一次性导入所有照片，可以按年份或专辑分批导入，便于问题定位。

2. 导入前验证：检查Takeout导出文件中是否包含所有需要的照片和对应的JSON元数据文件。

3. 日志分析：仔细分析导入日志，特别关注"added to an album"和"server has same asset"等关键信息。

4. 后期验证：导入完成后，抽样检查各专辑中的照片数量和代表性照片是否分配正确。

总结

immich-go作为Google相册到Immich的迁移工具，在大多数情况下工作良好，但在处理复杂专辑结构和特殊文件类型时仍存在改进空间。通过优化导出设置、采用正确的导入命令和分阶段验证，用户可以显著提高专辑信息迁移的成功率。开发团队也在持续改进工具，以更好地支持各种特殊场景下的照片迁移需求。