Strapi 5.4.0及以上版本文件上传功能异常分析与解决方案

问题背景

Strapi作为一款流行的开源无头CMS系统，在5.4.0版本中引入了一个影响文件上传功能的严重问题。该问题主要出现在当用户尝试更新已有媒体文件关联时，系统无法正确建立新的关联关系。

问题现象

在Strapi 5.4.0及后续版本中，当用户通过上传接口更新已关联媒体文件的实体时（例如更新用户头像），系统会出现以下异常行为：

1. 新文件能够成功上传到服务器
2. 文件上传过程没有报错
3. 但新上传的文件与实体之间的关联关系未能正确建立
4. 前端仍然显示旧的文件内容

技术分析

经过深入分析，发现问题根源在于数据库关系处理逻辑。当系统尝试更新一对一或一对多的媒体关联时：

1. 新记录会被创建在关联表中
2. 但旧记录没有被自动清理
3. 查询时系统默认返回第一条记录
4. 导致新上传的文件虽然存在，但无法被正确关联和显示

解决方案

目前有两种可行的解决方案：

临时解决方案

在代码层面先删除旧文件再上传新文件：

const handleSubmit = async (event) => {
  try {
    event.preventDefault();
    if (!user) return;
    
    // 先删除旧文件
    if(user.avatar?.id) {
      await axios.delete("/upload/files/" + user.avatar.id);
    }
    
    // 再上传新文件
    const formData = new FormData(event.target);
    formData.append("ref", "plugin::users-permissions.user");
    formData.append("refId", `${user.id}`);
    formData.append("field", "avatar");
    await axios.post("/upload", formData);
  } catch (error) {
    console.error("上传失败", error);
  }
};

根本解决方案

社区贡献者提出了修改核心代码的方案，主要思路是：

1. 在建立新关联前先清理旧的一对一关联
2. 添加专门的清理逻辑处理非多对多关系
3. 确保数据库关联表的整洁性

该方案已经通过单元测试、前端测试和端到端测试验证，等待合并到主分支。

影响范围

该问题影响所有使用Strapi 5.4.0及以上版本的项目，特别是：

1. 使用媒体字段的内容类型
2. 需要频繁更新媒体文件的场景
3. 用户头像等需要替换而非新增的功能

最佳实践建议

在官方修复发布前，建议开发者：

1. 暂时回退到5.3.0版本
2. 或采用先删除后上传的临时方案
3. 密切跟踪官方更新动态
4. 在测试环境中充分验证文件更新功能

总结

Strapi的文件上传功能在5.4.0版本引入的这一问题，虽然不影响首次上传，但对需要更新文件的场景造成了严重影响。开发者需要根据项目实际情况选择合适的应对方案，同时期待官方尽快发布修复版本。