Immich项目中的文件扩展名重复问题分析

问题背景

在Immich项目的1.130.2版本中，用户报告了一个关于存储模板迁移导致文件扩展名重复的问题。当用户执行存储模板迁移任务时，系统会将原本正常的文件扩展名（如".heic"）转换为重复的扩展名格式（如".HEIC.heic"）。这个问题不仅影响了通过immich-go上传的文件，也影响了通过iOS应用上传的资产。

问题表现

具体表现为：

1. 原始文件名：IMG_3025.heic
2. 迁移后文件名：IMG_3025.HEIC.heic
3. 同时影响了主文件和对应的XMP侧车文件

在数据库记录中，系统正确地更新了文件路径，但物理文件却被重命名为包含重复扩展名的形式。这个问题在HEIC和MP4格式的文件上均有出现。

技术分析

根据社区成员的深入调查，这个问题可以通过以下步骤复现：

1. 设置存储模板为特定格式（如"{{y}}/{{y}}-{{MM}}-{{dd}}/{{filename}}"）
2. 上传一个扩展名为大写的文件（如.HEIC）
3. 等待资产处理完成
4. 从管理面板强制运行完整的存储模板迁移
5. 观察文件被重命名为包含重复扩展名的形式

核心问题可能出在文件扩展名处理逻辑上。系统在处理文件扩展名时，可能没有正确处理大小写转换和扩展名去重逻辑。当原始文件名包含大写扩展名时，系统在生成新文件名时保留了原始扩展名，同时又添加了新的小写扩展名，导致了重复。

影响范围

这个问题影响了：

• 通过不同客户端上传的文件（包括immich-go和原生移动应用）
• 多种文件格式（HEIC、MP4等）
• 主文件和对应的元数据文件

解决方案建议

针对这个问题，开发者可以考虑以下修复方案：

1. 在存储模板处理逻辑中添加扩展名规范化步骤，统一转换为小写
2. 在处理文件名时，先去除已有扩展名，再添加新的规范化扩展名
3. 添加扩展名重复检查逻辑，避免重复添加相同扩展名
4. 对于迁移任务，增加文件名冲突检测机制

最佳实践

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

1. 在升级到修复版本前，谨慎执行存储模板迁移
2. 定期备份重要媒体文件
3. 监控系统日志，关注文件名变更相关的警告信息
4. 对于已受影响文件，可以编写脚本批量修复文件名

总结

Immich项目中的这个文件扩展名重复问题展示了在文件处理系统中处理大小写敏感性和扩展名规范化的重要性。开发者需要确保文件名处理逻辑在各种情况下都能保持一致性和正确性。对于用户来说，理解这个问题有助于更好地规划文件存储策略和迁移计划。

这个问题也提醒我们，在开发文件管理系统时，需要特别注意文件名处理的边界情况，包括不同操作系统的大小写敏感性差异、特殊字符处理以及扩展名规范化等问题。