Immich-Go项目解决Google Photos迁移中的上传中断问题

在将大量照片从Google Photos迁移到Immich平台的过程中，许多用户遇到了上传过程中因服务器错误而中断的问题。本文将深入分析这一问题的成因，并详细介绍解决方案。

问题背景

当用户尝试使用immich-go工具从Google Photos导出数据（通常包含数十万张照片）时，上传过程可能会遇到各种服务器错误。这些错误具有以下特点：

1. 随机性：错误发生的时间和位置难以预测
2. 中断性：默认情况下遇到错误会终止整个上传过程
3. 重复性：需要手动重新开始上传

技术分析

问题的核心在于两个技术层面：

1. 错误处理机制缺失：早期版本的immich-go在上传Google Photos数据时，不支持--on-server-errors参数，导致无法在遇到错误时继续上传。

2. 标签系统冲突：默认启用的会话标签(session-tag)和导出标签(takeout-tag)功能在某些情况下会与服务器产生冲突，这是导致大部分错误的根本原因。

解决方案

最新版本的immich-go(v0.24.6及以上)已经解决了这些问题，用户可以通过以下配置实现稳定上传：

immich-go.exe upload from-google-photos \
    -t -u \
    --include-untitled-albums \
    -s http://服务器地址:端口 \
    -k API密钥 \
    takeout-*.zip \
    --on-server-errors=continue \
    --session-tag=FALSE \
    --takeout-tag=FALSE

参数说明

• --on-server-errors=continue：使上传过程在遇到服务器错误时继续执行
• --session-tag=FALSE：禁用会话标签功能
• --takeout-tag=FALSE：禁用导出标签功能
• -t：保留原始文件时间戳
• -u：跳过已存在的文件
• --include-untitled-albums：包含无标题相册

最佳实践建议

1. 分批处理：对于超大规模迁移(如30万+照片)，建议将takeout文件分批处理。

2. 网络稳定性：确保上传过程中网络连接稳定，减少因网络问题导致的错误。

3. 日志监控：即使设置了继续上传，也应定期检查日志文件，了解发生的错误类型。

4. 资源管理：大型迁移会消耗大量系统资源，建议在服务器负载较低时执行。

技术原理

禁用标签功能的根本原因在于Immich服务器的处理机制。当同时处理大量带有特殊标签的媒体文件时，服务器端的数据库索引和标签管理系统可能会出现过载或冲突。通过禁用这些非必要的标签功能，可以显著降低服务器压力，提高上传成功率。

总结