Mockoon中多文件上传问题的分析与解决

问题背景

Mockoon是一款流行的API模拟工具，在9.0.0版本中存在一个关于multipart/form-data格式上传多个文件的问题。当开发者使用相同的字段名上传多个文件时（例如使用FormData.append()方法），Mockoon返回的文件元数据格式不正确。

问题现象

开发者在使用Mockoon测试文件上传接口时，如果采用以下方式上传多个文件：

const formData = new FormData();
files.forEach((file) => formData.append('files', file));

期望得到的是一个包含所有文件元数据的数组，但实际返回的是一个嵌套对象：

{
    "filename": "gladiator.jpg",
    "mimetype": "image/jpeg",
    "size": 34387,
    "": {
        "filename": "boots.jpg",
        "mimetype": "image/jpeg",
        "size": 154791
    }
}

技术分析

1. FormData规范：根据MDN文档，FormData.append()方法会将新值追加到现有键的末尾，而不是覆盖。这与FormData.set()方法的行为不同。

2. Mockoon的处理逻辑：在9.0.0版本中，Mockoon虽然能够接收multipart/form-data格式的请求，并能获取文件的元数据（文件名、MIME类型、大小），但对多个同名文件字段的处理存在缺陷。

3. 预期行为：正确的处理方式应该是返回一个数组，其中每个元素包含对应文件的元数据。

解决方案

Mockoon团队在9.1.0版本中修复了这个问题。新版本能够正确处理以下情况：

• 使用相同字段名上传多个文件
• 保持FormData.append()方法的规范行为
• 返回格式正确的文件元数据数组

最佳实践

在使用Mockoon测试文件上传接口时，建议：

1. 明确区分使用append()和set()方法的不同场景
2. 升级到9.1.0或更高版本以获得正确的多文件上传支持
3. 在模板中使用{{body '字段名'}}来验证上传的文件元数据

总结

这个问题的解决体现了Mockoon团队对API模拟准确性的重视。对于开发者而言，及时更新工具版本可以避免在测试过程中遇到类似的问题，确保API开发与测试的顺利进行。