ASP.NET Core MVC文件上传逻辑未执行问题求助

1. 确认表单enctype属性 #

表单必须设置enctype="multipart/form-data"才能正确携带文件数据提交到服务器，这是文件上传的核心前提。检查Upload.cshtml中的form标签：

<form asp-action="Upload" method="post" enctype="multipart/form-data">
    <!-- 表单控件 -->
</form>

2. 验证控制器动作的参数绑定 #

• 确保DocumentController的Upload方法标记了[HttpPost]特性，仅处理POST请求；
• 确认UploadDocumentModel中的文件属性为IFormFile类型，且名称与表单中文件输入的name属性完全一致；
• 动作方法参数需正确接收模型，示例如下：

[HttpPost]
public async Task<IActionResult> Upload(UploadDocumentModel model)
{
    // 后续上传逻辑
}

3. 检查模型验证状态 #

如果ModelState.IsValid返回false，会直接返回视图，跳过上传逻辑。可以在动作方法开头添加验证检查，同时在视图中显示错误提示：

if (!ModelState.IsValid)
{
    return View(model);
}

视图中添加验证摘要：

<div asp-validation-summary="All" class="text-danger"></div>

同时确认UploadDocumentModel的验证特性（如[Required]）是否符合实际输入场景，避免因不必要的验证拦截请求。

4. 调整文件上传大小限制 #

ASP.NET Core默认限制上传文件大小为30MB，若文件超出此限制，请求会被直接拦截，控制器动作不会执行。可在Program.cs中修改配置：

builder.Services.Configure<FormOptions>(options =>
{
    options.MultipartBodyLengthLimit = 104857600; // 设置为100MB
});

5. 排查路由与请求问题 #

• 确认asp-action="Upload"指向的控制器动作路由正确，可在动作上添加[Route("Document/Upload")]明确路由；
• 打开浏览器开发者工具（F12），切换到网络标签，点击上传按钮后查看请求状态：
  • 404状态码：路由映射错误；
  • 400状态码：请求参数验证失败；
  • 无请求发送：可能是前端JavaScript阻止了表单默认提交行为，检查控制台是否有JS报错。

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