如何解决ASP.NET Web API接收IFormFile为Null的问题

兄弟，我帮你梳理下你遇到的问题，你现在的核心问题出在几个关键的代码写法和配置错误上，咱们一步步来修正：

首先要明确：你用的是传统ASP.NET Web API还是ASP.NET Core？ #

你代码里用的HttpConfiguration是传统ASP.NET Web API的配置方式，但IFormFile是ASP.NET Core特有的类型，这俩不兼容！这很可能是你接收不到文件的核心原因之一，我分两种情况给你解决方案：

情况1：你确实在用传统ASP.NET Web API（OWIN自托管） #

传统Web API不支持IFormFile，得用MultipartFormDataStreamProvider来处理文件上传，同时修正你的配置：

修正后的控制器代码

public class ValuesController : ApiController
{
    public async Task<IHttpActionResult> Post()
    {
        // 先校验请求格式是否正确
        if (!Request.Content.IsMimeMultipartContent())
        {
            return BadRequest("请使用 multipart/form-data 格式发送请求");
        }

        // 设置文件临时存储路径（你可以改成自己想要的路径）
        var tempPath = Path.GetTempPath();
        var provider = new MultipartFormDataStreamProvider(tempPath);

        try
        {
            // 读取并解析multipart请求内容
            await Request.Content.ReadAsMultipartAsync(provider);

            // 获取上传的第一个文件（如果有多个可以遍历FileData）
            var uploadedFile = provider.FileData.FirstOrDefault();
            if (uploadedFile != null)
            {
                // uploadedFile.LocalFileName是文件保存到临时目录的路径
                var fileName = uploadedFile.Headers.ContentDisposition.FileName.Trim('"');
                return Ok($"Success: 收到文件！文件名：{fileName}，临时存储路径：{uploadedFile.LocalFileName}");
            }
            else
            {
                return BadRequest("ERROR: 没有接收到任何文件");
            }
        }
        catch (Exception ex)
        {
            return InternalServerError(ex);
        }
    }
}

修正后的Startup.cs配置

public void Configuration(IAppBuilder app)
{
    var config = new HttpConfiguration();
    
    // 配置标准API路由，确保请求能正确匹配到控制器动作
    config.Routes.MapHttpRoute(
        name: "DefaultApi",
        routeTemplate: "api/{controller}/{id}",
        defaults: new { id = RouteParameter.Optional }
    );
    
    // CORS要放在UseWebApi之前启用，顺序很重要！
    app.UseCors(Microsoft.Owin.Cors.CorsOptions.AllowAll);
    config.EnableCors();
    
    // 删掉这行错误配置：JsonFormatter是处理JSON的，根本不需要支持multipart格式
    // config.Formatters.JsonFormatter.SupportedMediaTypes.Add(new MediaTypeHeaderValue("multipart/form-data"));
    
    app.UseWebApi(config);
}

情况2：你实际想用ASP.NET Core Web API（OWIN自托管） #

如果是Core版本，IFormFile是支持的，但你的配置和控制器写法需要调整：

修正后的控制器代码

[ApiController]
[Route("api/[controller]")]
public class ValuesController : ControllerBase
{
    // 重点：不要加[FromBody]！IFormFile是从multipart表单中绑定的，不是JSON请求体
    [HttpPost]
    public IActionResult Post(IFormFile file)
    {
        if (file != null)
        {
            return Ok("Success: We got something!!!");
        }
        else
        {
            return BadRequest("ERROR: We got nothing :-(");
        }
    }
}

修正后的Startup.cs（Core版本）

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddControllers();
        // 配置允许所有跨域请求（生产环境建议限制来源）
        services.AddCors(options =>
        {
            options.AddPolicy("AllowAll", policy =>
            {
                policy.AllowAnyOrigin()
                      .AllowAnyMethod()
                      .AllowAnyHeader();
            });
        });
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }

        app.UseRouting();
        // 启用CORS要在路由和授权之间
        app.UseCors("AllowAll");
        app.UseAuthorization();

        app.UseEndpoints(endpoints =>
        {
            endpoints.MapControllers();
        });
    }
}

Postman请求的正确操作步骤 #

不管用哪种版本，Postman里都要这么设置才能正确上传：

• 选择POST方法，输入API地址（比如http://localhost:5000/api/values）
• 切换到Body标签，选择form-data
• 在Key列输入file（必须和控制器的参数名完全一致）
• Key右边的类型默认是Text，一定要改成File
• 点击Value列的「Select Files」选择要上传的文件
• 不要手动设置Content-Type请求头！Postman会自动生成带边界的multipart/form-data头
• 发送请求，就能收到成功响应了

常见坑总结 #

1. 传统Web API别用IFormFile，那是Core专属的
2. 不要给IFormFile加[FromBody]，文件不是JSON请求体里的内容
3. 别乱改JsonFormatter的支持类型，multipart请求有专门的解析器
4. Postman里Key的名字必须和参数名一致，类型要选File

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