Immich-Go项目中的Google Photos相册导入问题解析

在照片管理工具Immich-Go的最新版本中，用户报告了一个关于Google Photos相册导入的重要问题：当用户使用Google Takeout导出数据后，通过Immich-Go导入时，部分相册无法正确创建，而其中的照片却能正常上传。这个问题引起了开发团队的重视，并进行了深入的技术分析。

问题背景

Google Photos的Takeout导出包中，每个相册都会包含一个metadata.json文件，用于存储相册的元数据信息。近期Google似乎对metadata.json的格式进行了调整，导致Immich-Go无法正确解析这些文件，从而无法创建对应的相册。

技术分析

从用户提供的示例来看，新的metadata.json文件格式变得更为简洁，例如：

{
  "title": "Basement Office"
}

而旧版本可能包含更丰富的信息，如：

{
  "title": "Album Title",
  "enrichments": [{
    "locationEnrichment": {
      "location": [{
        "name": "Location Name",
        "description": "Region",
        "latitudeE7": 12345789,
        "longitudeE7": 123456789
      }]
    }
  }]
}

Immich-Go的解析逻辑需要适应这种格式变化。开发团队在v0.23版本中已经修复了这个问题，但用户需要注意：

1. 确保使用最新版本的Immich-Go
2. 共享相册("Shared with me")目前不会被导入为相册，这是已知行为
3. 导入后，在Immich界面中默认只显示前3个相册，需要点击"查看全部"才能看到完整列表

解决方案

对于遇到此问题的用户，建议：

1. 升级到Immich-Go v0.24或更高版本
2. 检查导入日志中是否有"unsupported file"警告
3. 如果仍有问题，可以向开发团队提供具体的metadata.json示例和日志文件

最佳实践

为了确保Google Photos数据完整迁移：

1. 在导入前先测试小批量数据
2. 保留原始Takeout文件作为备份
3. 导入完成后，仔细检查相册数量和内容是否匹配
4. 对于共享相册，可能需要手动在Immich中重新创建

这个案例展示了云服务API变化对数据迁移工具的影响，也提醒开发者在设计解析逻辑时要考虑格式的灵活性和向前兼容性。Immich-Go团队对这类问题的快速响应体现了项目对用户体验的重视。