.NET5 API一对多关系模型中子类IFormFile属性绑定失败参数为空

导致绑定失败的两个核心原因 #

1. 子集合类的表单字段命名不符合ASP.NET Core模型绑定规则
2. 子模型中存在对父模型的导航属性，触发循环绑定导致绑定失败

第一步：修改模型配置 #

给子模型的导航属性添加[BindNever]特性，禁止模型绑定器解析该属性，避免循环绑定异常：

public class CategoryDetail
{
    public int Id { get; set; }
    public string Url { get; set; }
    public IFormFile File { get; set; }
    // 添加该特性禁止绑定导航属性
    [BindNever]
    public Category Category { get; set; }
}

第二步：调整Postman表单参数命名 #

ASP.NET Core对表单提交的集合类型属性，要求参数名遵循集合属性名[索引].子属性名的规则，索引从0开始连续计数，示例配置如下：

• 父类名称字段：key填Name，值填分类名称
• 第一个子元素ID：key填CategoryDetails[0].Id，值填对应ID
• 第一个子元素Url：key填CategoryDetails[0].Url，值填对应Url
• 第一个子元素上传文件：key填CategoryDetails[0].File，类型选file，选择对应上传文件
• 第二个子元素以此类推，索引改为1即可：CategoryDetails[1].Id、CategoryDetails[1].Url、CategoryDetails[1].File

其他注意事项 #

• Postman提交时选择form-data类型，不要手动修改Content-Type请求头，框架会自动生成带boundary的multipart/form-data头
• 集合索引必须从0开始连续，不能出现跳号（比如0之后直接写2），否则跳号后的所有元素都无法绑定
• 如果需要允许不连续索引，可以额外配置表单绑定规则，常规场景下连续索引即可满足需求

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