ASP.NET MVC模型验证失败后如何保留并显示IFormFile文件

问题根源 #

浏览器出于安全限制，不会在表单回发时自动保留已选择的文件；同时IFormFile是一次性的请求对象，无法在返回视图时被序列化回传给前端。因此需要通过服务器端临时存储+视图显示已上传文件信息的方式实现需求。

解决方案步骤 #

1. 修改模型类，增加文件名显示属性

新增字符串属性用于在视图中展示已上传的文件名：

public class Employee
{
    public IFormFile Attachment { get; set; }
    // 用于显示已上传的文件名
    public string AttachmentFileName { get; set; }
}

2. 调整控制器逻辑，临时存储上传文件

验证失败时将文件保存到服务器临时目录，通过TempData记录临时文件路径和原文件名；验证通过后再将临时文件移至目标存储位置：

public IActionResult AddEmployee(Employee model)
{
    // 执行模型验证
    if (!ModelState.IsValid)
    {
        // 处理已上传的文件
        if (model.Attachment != null && model.Attachment.Length > 0)
        {
            // 生成唯一文件名避免冲突
            var uniqueFileName = Guid.NewGuid().ToString() + Path.GetExtension(model.Attachment.FileName);
            var tempFilePath = Path.Combine(Path.GetTempPath(), uniqueFileName);
            
            // 保存文件到临时目录
            using (var stream = new FileStream(tempFilePath, FileMode.Create))
            {
                model.Attachment.CopyTo(stream);
            }
            
            // 存储临时路径和原文件名到TempData
            TempData["TempAttachmentPath"] = tempFilePath;
            TempData["AttachmentOriginalFileName"] = model.Attachment.FileName;
            // 赋值给模型属性用于视图显示
            model.AttachmentFileName = model.Attachment.FileName;
        }
        // 保留之前的临时文件信息（多次验证失败场景）
        else if (TempData.ContainsKey("TempAttachmentPath"))
        {
            model.AttachmentFileName = TempData["AttachmentOriginalFileName"].ToString();
            // 保留TempData值，避免读取后被清除
            TempData.Keep("TempAttachmentPath");
            TempData.Keep("AttachmentOriginalFileName");
        }
        
        return View("Add", model);
    }

    // 验证通过，处理文件
    if (TempData.ContainsKey("TempAttachmentPath"))
    {
        var tempPath = TempData["TempAttachmentPath"].ToString();
        var originalFileName = TempData["AttachmentOriginalFileName"].ToString();
        
        // 替换为你的目标存储路径
        var targetPath = Path.Combine("wwwroot/uploads", originalFileName);
        Directory.CreateDirectory(Path.GetDirectoryName(targetPath));
        // 将临时文件移至目标位置
        File.Move(tempPath, targetPath);
        // 可选：删除临时文件
        // File.Delete(tempPath);
    }
    else if (model.Attachment != null && model.Attachment.Length > 0)
    {
        // 第一次提交即验证通过，直接处理上传文件
        var targetPath = Path.Combine("wwwroot/uploads", model.Attachment.FileName);
        using (var stream = new FileStream(targetPath, FileMode.Create))
        {
            model.Attachment.CopyTo(stream);
        }
    }

    return View("View");
}

3. 修改视图，显示错误信息和已上传文件

在视图中添加模型错误提示，并展示已上传的文件名：

<form method="post" enctype="multipart/form-data">
    <!-- 显示模型验证错误 -->
    @if (!ViewData.ModelState.IsValid)
    {
        <div class="alert alert-danger">
            <ul>
                @foreach (var error in ViewData.ModelState.Values.SelectMany(v => v.Errors))
                {
                    <li>@error.ErrorMessage</li>
                }
            </ul>
        </div>
    }

    <div class="row">
        <div class="col-sm-5 col-md-6">
            <div class="form-group">
                <label>Attachment</label>
                <input name="Attachment" id="Attachment" type="file" accept=".doc,.docx,.xls,.xlsx,.ppt,.pptx,.jpg,.jpeg,.png,.bmp,.tiff,.pdf,.msg,.zip" style="font-weight:normal;">
                
                <!-- 显示已上传的文件信息 -->
                @if (!string.IsNullOrEmpty(Model.AttachmentFileName))
                {
                    <div class="mt-2 text-success">
                        已上传文件：@Model.AttachmentFileName
                    </div>
                }
            </div>
        </div>
    </div>

    <!-- 其他表单字段 -->
    <div class="form-group mt-3">
        <button type="submit" class="btn btn-primary">提交</button>
    </div>
</form>

额外注意事项 #

• 临时文件清理：服务器临时目录的文件不会自动删除，建议添加定时任务（如Hosted Service）清理超过24小时的临时文件。
• 安全防护：验证文件大小、类型，避免恶意文件上传；使用Guid生成临时文件名，防止路径遍历攻击。
• TempData生命周期：TempData默认仅保留一次请求，需要使用Keep()方法保留值直到验证通过。

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