Immich-go项目中照片时间戳丢失问题的分析与解决方案

问题背景

在使用immich-go工具将iCloud照片库迁移至Immich平台时，用户遇到了一个典型的时间戳丢失问题。通过icloud_photos_downloader工具下载的照片虽然保留了完整的EXIF元数据（包括DateTime、DateTimeOriginal和时区信息），但在上传到Immich后，照片在时间线中仅按日期排序，时间部分被统一设置为中午12点，导致时间顺序错乱。

问题根源分析

经过深入调查，发现问题的核心在于immich-go的元数据处理机制。当照片按照"年/月/日"的目录结构存储时，immich-go会优先从文件路径中提取日期信息，而不会完全依赖EXIF元数据中的时间戳。这种行为虽然提高了处理效率，但导致了时间精度的丢失。

此外，XMP侧边文件的存在也会影响元数据的提取过程。即使原始照片包含完整的EXIF信息，如果存在XMP文件，系统会优先使用XMP中的元数据，这可能进一步导致时间戳信息的不准确。

技术解决方案

临时解决方案

1. 删除XMP侧边文件：通过脚本删除所有XMP文件后，Immich会自动触发"提取元数据"作业，从原始照片中重新获取完整的EXIF信息，包括精确的时间戳。

2. 手动触发元数据重建：在Immich界面中执行元数据重建作业，确保系统从原始文件中重新读取所有元数据。

长期改进建议

1. 元数据提取策略优化：建议immich-go增加配置选项，允许用户选择元数据提取策略：

   • 强制使用EXIF元数据（忽略文件路径）
   • 优先使用文件路径日期
   • 使用exiftool进行高级元数据提取

2. XMP文件处理优化：增加上传时的选项，允许用户选择是否包含XMP文件，确保元数据提取作业能够正确处理原始EXIF信息。

技术实现细节

在数据库层面，问题表现为assets表中的fileCreatedAt字段仅包含日期部分，时间部分被设置为默认值。例如：

"fileCreatedAt": "2022-05-21 00:00:00+00"

正确的实现应该从EXIF中提取完整的时间戳，包括时区信息。对于iCloud下载的照片，典型的EXIF数据结构包含：

• DateTime: 2022:05:21 12:20:48
• DateTimeOriginal: 2022:05:21 12:20:48
• Timezone: +12:00 (Pacific/Auckland)

最佳实践建议

对于从iCloud迁移照片到Immich的用户，建议采用以下工作流程：

1. 使用icloud_photos_downloader时，选择下载原始文件而非衍生版本
2. 在上传前检查照片的EXIF信息是否完整
3. 考虑先删除可能存在的XMP侧边文件
4. 上传完成后，立即触发元数据重建作业
5. 验证时间线中的照片是否按正确时间顺序排列

未来展望

随着immich-go项目的持续发展，预计将在后续版本中提供更灵活的元数据处理选项，使不同来源的照片迁移都能保持完整的时间戳信息。对于需要精确时间管理的用户，建议关注项目更新，特别是对EXIF处理逻辑的改进。