提交时Kendo Upload未绑定MVC模型，文件属性为空求助

我之前也碰到过一模一样的问题，咱们一步步排查可能的原因，大概率能解决：

1. 确认模型属性的类型是否正确 #

多文件上传时，模型里的属性必须是集合类型，而不是单个HttpPostedFileBase。比如：

public class UploadModel
{
    // 正确：支持多文件的集合类型
    public IEnumerable<HttpPostedFileBase> UploadedFiles { get; set; }

    // 错误：只能接收单个文件，多文件上传时会返回null
    // public HttpPostedFileBase UploadedFile { get; set; }
}

注意属性必须是public，并且有get和set方法，否则模型绑定器无法赋值。

2. 检查Kendo Upload的配置是否适配同步上传 #

因为你是要同步上传（通过表单提交），必须禁用Kendo Upload的异步自动上传功能，否则控件会自己发起异步请求，而不是通过表单提交文件：

@using (Html.BeginForm("SubmitUpload", "YourController", FormMethod.Post, new { enctype = "multipart/form-data" }))
{
    @(Html.Kendo().Upload()
        .Name("UploadedFiles") // 这里的名称必须和模型属性名完全一致
        .Multiple(true) // 允许选择多个文件
        .Async(async => async
            .AutoUpload(false) // 关键：禁止自动异步上传，交由表单提交
        )
    )
    <button type="submit">提交上传</button>
}

这里的Name属性一定要和模型里的属性名完全匹配（MVC模型绑定默认不区分大小写，但最好严格一致避免坑）。

3. 验证表单和控制器Action的配置 #

• 确保form标签的enctype="multipart/form-data"没有拼写错误，并且确实包裹了Kendo Upload控件和提交按钮。
• 控制器的Action必须标记[HttpPost]特性，并且参数是你的模型类：

[HttpPost]
public ActionResult SubmitUpload(UploadModel model)
{
    // 这里检查model.UploadedFiles是否有值
    if (model.UploadedFiles != null && model.UploadedFiles.Any())
    {
        foreach (var file in model.UploadedFiles)
        {
            // 处理文件逻辑，比如保存到服务器
            var savePath = Path.Combine(Server.MapPath("~/Uploads"), Path.GetFileName(file.FileName));
            file.SaveAs(savePath);
        }
    }
    return RedirectToAction("Index");
}

4. 排查文件大小限制问题 #

如果上传的文件过大，IIS会直接截断请求，导致模型绑定失败（属性为null）。需要在web.config中调整配置：

• 在<system.web>节点下添加：

<httpRuntime maxRequestLength="1048576" executionTimeout="3600" />
<!-- maxRequestLength单位是KB，这里设置为1GB -->

• 如果是IIS 7及以上版本，还要在<system.webServer>节点下添加：

<security>
    <requestFiltering>
        <requestLimits maxAllowedContentLength="1073741824" />
        <!-- maxAllowedContentLength单位是字节，这里设置为1GB -->
    </requestFiltering>
</security>

5. 检查请求验证设置 #

如果上传的文件名包含特殊字符，可能会触发MVC的请求验证，导致模型绑定失败。可以在Action上添加[ValidateInput(false)]特性（注意.NET Framework版本，.NET Core的话是[RequestFormLimits(MultipartBodyLengthLimit = ...)]）：

[HttpPost]
[ValidateInput(false)]
public ActionResult SubmitUpload(UploadModel model)
{
    // 处理逻辑
}

按照上面的步骤逐一排查，应该就能解决模型文件属性为null的问题了。

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