Lychee相册管理系统中的文件后缀重复问题分析与解决方案

问题现象

在使用Lychee相册管理系统v5.3版本时，用户发现通过"下载相册"功能获取的压缩包中，图片文件名会出现后缀重复的问题。例如，原始文件名为"IMG_123.jpeg"的图片，在下载后会变成"IMG_123.jpeg.jpeg"。

问题根源分析

经过深入调查，发现该问题与系统版本升级和前端界面变更有关：

1. 新旧版本差异：在v5版本的新前端界面中，上传图片时会完整保存文件名（包括扩展名）作为图片标题，而旧版本则不会保存扩展名部分。

2. 下载逻辑问题：系统在生成下载文件名时，会基于图片标题自动添加文件扩展名，导致当标题已包含扩展名时出现重复后缀。

3. 特定触发条件：

   • 仅影响通过新前端界面(v5)上传的图片
   • 对在导入过程中被调整大小的图片无影响
   • 单张图片原始尺寸下载也会出现同样问题

技术解决方案

临时解决方案

对于已经出现问题的系统，可以通过数据库操作临时修复：

UPDATE photos SET title = SUBSTRING(title, 1, LENGTH(title) - 4) WHERE title LIKE '%.jpg';

注意：此SQL会移除所有以".jpg"结尾的标题的最后4个字符，使用时需谨慎评估影响范围。

系统修复方案

从根本上解决此问题需要考虑以下方向：

1. 上传逻辑调整：在上传过程中自动去除文件扩展名，保持与旧版本一致的行为。

2. 下载逻辑优化：在生成下载文件名时，先检查标题是否已包含扩展名，避免重复添加。

3. 版本兼容处理：针对新旧版本上传的图片采用不同的文件名生成策略，确保向后兼容。

最佳实践建议

1. 对于生产环境，建议等待官方发布修复版本后再进行大规模文件操作。

2. 如需立即使用下载功能，可考虑先批量修改数据库中的图片标题，去除扩展名部分。

3. 在系统升级后，应测试下载功能是否正常工作，特别是针对不同时期上传的图片。

总结

Lychee相册管理系统中的文件后缀重复问题源于新旧版本上传逻辑的差异，通过理解其根本原因，用户可以采取适当的临时措施或等待官方修复。这类问题也提醒我们在系统升级时需要特别注意前后版本的功能兼容性，特别是涉及核心数据存储和处理的变更。