ASP.NET MVC（.NET4.6.1）Ajax上传文件时参数file为null的问题求助

问题根源 #

你使用的是基于System.Web的传统ASP.NET MVC（.NET4.6.1），却错误引入了ASP.NET Core专属的Microsoft.AspNetCore.Http包并使用IFormFile类型——该类型与传统MVC框架完全不兼容。同时，FormData键名与Action参数名不匹配，也是导致参数为null的核心原因。

分步解决方案 #

1. 移除ASP.NET Core相关依赖

卸载Microsoft.AspNetCore.Http包，该包属于ASP.NET Core生态，与传统ASP.NET MVC存在框架冲突，完全不适用于当前项目。

2. 修正前端FormData配置

确保FormData中的键名与后端Action参数名完全一致，或直接通过表单实例构建FormData（更可靠，自动同步所有表单字段）：

方式一：手动指定键名（匹配参数名）

$('#uploadButton').click(function () {
    var formData = new FormData();
    // 键名'file'需与后端Action的参数名完全匹配
    formData.append('file', $('#fileInput')[0].files[0]);

    $.ajax({
        url: '/YourController/Upload', // 替换为实际的控制器/Action名称
        type: 'POST',
        data: formData,
        processData: false,
        contentType: false,
        success: function (response) {
            console.log('File uploaded successfully:', response);
            alert('success');
        },
        error: function (xhr, status, error) {
            console.error('Error uploading file:', error);
            alert('error');
        }
    });
});

方式二：直接通过表单构建FormData（推荐）

$('#uploadButton').click(function () {
    // 直接从表单实例创建FormData，无需手动拼接字段
    var formData = new FormData($('#fileUploadForm')[0]);

    $.ajax({
        url: '/YourController/Upload',
        type: 'POST',
        data: formData,
        processData: false,
        contentType: false,
        success: function (response) {
            console.log('File uploaded successfully:', response);
            alert('success');
        },
        error: function (xhr, status, error) {
            console.error('Error uploading file:', error);
            alert('error');
        }
    });
});

3. 修正后端Action方法

使用传统ASP.NET MVC专属的HttpPostedFileBase类型，并确保参数名与FormData键名匹配：

[HttpPost]
public async Task<ActionResult> Upload(HttpPostedFileBase file)
{
    int statusCode = (int)HttpStatusCode.InternalServerError;

    try
    {
        if (file != null && file.ContentLength > 0)
        {
            // 示例：将文件保存到服务器指定目录
            var fileName = Path.GetFileName(file.FileName);
            var savePath = Path.Combine(Server.MapPath("~/Uploads"), fileName);
            file.SaveAs(savePath);
            
            statusCode = (int)HttpStatusCode.OK;
        }
        else
        {
            // 无有效文件上传时返回400错误
            statusCode = (int)HttpStatusCode.BadRequest;
        }
    }
    catch (Exception ex)
    {
        // 可添加日志记录逻辑
        statusCode = (int)HttpStatusCode.InternalServerError;
    }

    return Json(new { statusCode });
}

4. 配置大文件上传限制（可选）

如果需要上传超过默认大小的文件，在web.config中添加以下配置：

<system.web>
    <!-- 最大请求大小，单位KB，示例为1GB -->
    <httpRuntime maxRequestLength="1048576" />
</system.web>
<system.webServer>
    <security>
        <requestFiltering>
            <!-- 最大请求内容长度，单位字节，示例为1GB -->
            <requestLimits maxAllowedContentLength="1073741824" />
        </requestFiltering>
    </security>
</system.webServer>

关键注意事项 #

• 确保AJAX请求的url路径正确，格式为/控制器名/Action名（控制器名不含Controller后缀）
• 表单的enctype="multipart/form-data"属性必须保留，AJAX的processData和contentType必须设为false

内容的提问来源于stack exchange，提问作者SYED NAWAZ PRINCE