Immich-go项目中的RAW与JPG文件上传问题分析与解决方案

问题背景

在Immich-go项目中，用户报告了一个关于RAW格式文件上传的问题。当用户尝试上传包含JPG和RAW格式（如CR2、NEF等）文件的文件夹时，发现只有JPG文件被成功上传，而RAW文件虽然被扫描识别，但最终未被上传到服务器。

问题现象

用户在使用Immich-go上传命令时，日志显示系统能够正确扫描到RAW格式文件（如CR2、NEF等），但在上传阶段这些文件被跳过。有趣的是，不同用户报告了相反的行为：有些用户发现只有RAW文件被上传，而JPG文件被忽略。

技术分析

文件处理机制

Immich-go在0.21版本中对文件处理流程进行了调整。上传过程分为几个关键阶段：

1. 文件扫描阶段：系统会扫描指定目录中的所有文件，识别支持的格式
2. 元数据提取阶段：从文件中提取拍摄日期等元数据
3. 文件上传阶段：将文件上传到Immich服务器

问题根源

经过分析，问题主要出在以下几个方面：

1. 日期解析问题：EXIF数据不包含时区信息，系统使用本地时区解析DateTimeOriginal标签，导致JPG和RAW文件的拍摄时间不一致
2. RAW文件元数据处理：Immich-go对某些RAW格式（如NEF）的元数据支持不完善，导致无法正确提取拍摄时间
3. 文件堆叠功能失效：-stack-jpg-raw参数未能正常工作，导致关联的JPG和RAW文件无法正确堆叠

解决方案

项目维护者在0.23.0-alpha3版本中修复了这些问题。主要改进包括：

1. 增强RAW文件支持：完善了对NEF、CR2等RAW格式的元数据提取
2. 改进日期处理：优化了时区处理逻辑，确保JPG和RAW文件的拍摄时间一致
3. 修复堆叠功能：重新实现了-create-stacks和-stack-jpg-raw功能

最佳实践建议

对于需要上传JPG和RAW文件的用户，建议：

1. 使用最新版本的Immich-go（0.23.0及以上）
2. 明确指定时区参数（如-time-zone=Asia/Tokyo）
3. 使用-stack-jpg-raw参数确保关联文件正确堆叠
4. 对于大量文件上传，可以先在小样本上测试参数效果

技术细节补充

EXIF数据处理

在数码照片中，EXIF数据记录了丰富的元信息，但存在以下局限性：

1. 时间戳通常不包含时区信息
2. 不同相机厂商对RAW格式的实现差异较大
3. 文件系统时间（修改时间、访问时间等）不可靠，不应作为拍摄时间依据

文件堆叠原理

Immich的文件堆叠功能基于以下条件：

1. 文件名前缀相同（如DSC_0001.JPG和DSC_0001.NEF）
2. 拍摄时间相近（通常在几秒内）
3. 文件内容相关性验证

当这些条件满足时，系统会将文件组合成一个堆叠，在界面中以分组形式展示。

总结

Immich-go作为Immich生态的重要组件，在0.23.0版本中显著改进了对专业摄影工作流的支持。通过解决RAW文件上传和堆叠问题，使得摄影师能够更方便地管理他们的原始文件和成品照片。用户升级到最新版本后，可以期待更稳定和可靠的文件上传体验。