解决immich-go导入Google Takeout照片时元数据丢失问题

在使用immich-go工具从Google Takeout导入照片到Immich时，部分照片的拍摄日期未被正确识别，导致系统使用了当前时间而非照片实际拍摄时间。这一问题主要出现在文件名较长的照片上，特别是那些从社交媒体保存或接收的照片。

问题现象

用户报告称，某些特定类型的照片文件（如以"MSGR_PHOTO_FOR_UPLOAD"或长数字串开头的文件）在上传到Immich后，拍摄日期被错误地设置为导入时间而非实际拍摄时间。这些文件通常具有以下特征：

1. 文件名包含长数字串或特殊前缀
2. EXIF数据中缺少拍摄日期信息
3. 存在对应的JSON侧车文件，其中包含正确的拍摄时间戳

根本原因分析

经过调查，发现问题的核心在于：

1. 未使用专用参数：用户没有使用-google-photos参数，导致工具无法正确处理Google Takeout特有的文件结构和元数据关联方式。

2. 文件名处理逻辑：Google对长文件名进行了特殊处理，添加了序列号以避免重复，而JSON侧车文件中保留了原始文件名。没有专用参数时，工具难以正确匹配照片文件与其对应的元数据文件。

3. 元数据获取优先级：工具默认会优先尝试从文件名中提取日期信息，对于这类特殊命名的文件，这种启发式方法会失败。

解决方案

要正确导入Google Takeout照片并保留所有元数据，必须：

1. 使用专用参数：在运行immich-go时添加-google-photos参数，这将启用专门为Google Photos导出设计的处理逻辑。

2. 保持文件结构完整：导入时应保持Takeout导出的原始目录结构，确保照片文件与对应的JSON文件位于同一目录下。

3. 验证导入结果：导入后检查关键字段（特别是拍摄日期）是否正确，可通过Immich的界面或工具日志确认。

技术实现细节

当使用-google-photos参数时，immich-go会：

1. 扫描目录中的JSON文件，提取其中的photoTakenTime时间戳
2. 根据特定规则匹配照片文件与JSON文件（考虑Google的文件命名规则）
3. 将JSON中的元数据补充到照片文件中
4. 优先使用JSON中的时间信息，而非文件名或文件修改时间

最佳实践建议

1. 在导入前仔细阅读工具的Google Photos特定文档
2. 保留完整的Takeout导出结构，不要手动重命名或移动文件
3. 首次导入时使用小批量测试，验证元数据是否正确转移
4. 检查工具日志，确认是否有警告或错误信息

通过遵循这些指导原则，用户可以确保从Google Photos迁移到Immich时，所有照片的元数据都能得到完整保留和正确识别。