ASP.NET Core多文件上传模型绑定失败问题求助

核心问题 #

你遇到的Images数组绑定失败的原因，是前端FormData中多文件的键名不符合ASP.NET Core模型绑定的要求。虽然文件已成功上传到服务器，但模型绑定无法将这些文件关联到Images属性上。

模型绑定规则 #

ASP.NET Core对IFormFile[]类型的模型绑定，要求前端发送的每个文件必须使用与模型属性名完全一致的键名，支持两种格式：

• 重复使用同一个键名（推荐）：每个图片文件都用Images作为键
• 带索引的键名：比如Images[0]、Images[1]、Images[2]...

前端修复示例 #

假设用JavaScript构造FormData，正确写法如下：

const formData = new FormData();

// 单个预览图（键名与模型属性PreviewImage一致）
formData.append('PreviewImage', document.getElementById('previewImage').files[0]);

// 多个图片文件，重复使用Images作为键
const imageFiles = document.getElementById('images').files;
for (let i = 0; i < imageFiles.length; i++) {
    formData.append('Images', imageFiles[i]);
}

// 其他字段（数组类型字段同样重复键名）
formData.append('Title', '产品标题');
formData.append('PreviewDescription', '预览描述');
formData.append('CategoryIds', '1');
formData.append('CategoryIds', '2');

额外验证点 #

如果前端已按上述要求发送但仍绑定失败，可检查：

• 模型属性名Images的大小写是否与前端键名完全匹配（ASP.NET Core模型绑定默认区分大小写，除非手动配置不区分）
• 确认没有自定义模型绑定器干扰了默认的文件数组绑定逻辑

内容的提问来源于stack exchange，提问作者Aleksej_Shherbak