提交含IFormFile数组的EmailToProcess时数组属性为空的问题

问题核心原因 #

1. 属性命名与表单字段不匹配，原属性名IFormFile与类型名重复，易引发绑定歧义
2. 控制器循环逻辑错误，错误遍历email对象而非文件数组
3. 前端提交时未正确匹配文件字段名，导致无法绑定到数组

解决步骤 #

1. 修正模型属性命名 #

将模型中的数组属性重命名为清晰且不与类型名冲突的名称，确保与前端提交的表单字段名一致：

public class EmailToProcess
{
    public string From { get; set; }
    public string To { get; set; }
    // 其他字段...
    public IFormFile[] Attachments { get; set; } // 重命名为Attachments
}

2. 修复控制器循环逻辑 #

修正遍历对象和空值判断的错误，正确处理文件数组：

[HttpPost("CreateEmail")]
[Consumes("multipart/form-data")]
public async Task<ApiResponse<Guid>> PostEmailToProcess([FromForm]EmailToProcess email) 
{
    try
    {
        var emailToAdd = new EmailToProcessDto(email);
        emailToAdd.Created = DateTime.Now;

        var emailId = await _emailRepository.PostEmailAsync(emailToAdd);

        // 先判断数组是否非空，再遍历单个文件
        if (email.Attachments != null)
        {
            foreach (var file in email.Attachments)
            {
                if (file != null)
                {
                    await _contentUploadService.Upload(file, emailId.Data);
                }
            }
        }

        // 后续业务逻辑...
    }
    catch (Exception ex)
    {
        // 异常处理逻辑...
    }
}

3. 确保前端请求格式正确 #

提交multipart/form-data请求时，多个文件的表单字段名必须与模型数组属性名一致：

• API测试工具（如Postman）：添加多个文件，每个文件的Key设置为Attachments
• HTML表单：使用multiple属性允许选择多文件，字段名设为Attachments：

<form method="post" enctype="multipart/form-data" action="/CreateEmail">
    <input type="text" name="From" placeholder="发件人">
    <input type="text" name="To" placeholder="收件人">
    <input type="file" name="Attachments" multiple>
    <button type="submit">提交邮件</button>
</form>

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