ASP.Net Core 2中使用IFormFile上传图片出现空引用异常

我之前在做ASP.NET Core文件上传的时候也碰到过一模一样的问题，折腾了好一会儿才搞定，给你分享几个关键的排查点和解决办法：

1. 完善API参数绑定与空值检查 #

首先，IFormFile是专门用来接收multipart/form-data格式文件的，绝对不能加[FromBody]特性（你已经移除这点是对的），反而可以给fileStream参数加上[FromForm]特性明确绑定来源，同时必须添加空值检查避免空引用异常：

[HttpPost]
public async Task<IActionResult> Upload(int vId, [FromForm] IFormFile fileStream)
{
    // 先校验文件是否有效
    if (fileStream == null || fileStream.Length == 0)
    {
        return BadRequest("请上传有效的文件");
    }

    var vehicle = await this.repository.GetVehicle(vId, hasAdditional: false);
    if (vehicle == null) return NotFound();
    var uploadsFolderPath = Path.Combine(host.WebRootPath, "uploads");
    if (!Directory.Exists(uploadsFolderPath)) Directory.CreateDirectory(uploadsFolderPath);
    var fileName = Guid.NewGuid().ToString() + Path.GetExtension(fileStream.FileName);
    var filePath = Path.Combine(uploadsFolderPath, fileName);
    using (var stream = new FileStream(filePath, FileMode.Create))
    {
        await fileStream.CopyToAsync(stream);
    }
    // 记得返回成功响应，比如return Ok(new { fileName = fileName });
}

2. Postman请求配置必须严格匹配 #

这是最容易踩坑的环节，你需要确保Postman的请求完全符合multipart/form-data的要求：

• 请求URL与参数：选择POST方法，URL要包含vId参数（比如http://你的API域名/控制器名/Upload?vId=1，如果控制器有api/[controller]前缀，就改成http://你的API域名/api/控制器名/Upload?vId=1）
• Body选项卡：必须选择form-data类型，不能选raw、x-www-form-urlencoded等其他格式
• 文件字段配置：
  • 键名必须填fileStream（和API参数名完全一致，大小写尽量匹配，避免不必要的绑定问题）
  • 类型要从默认的Text改成File
  • 点击右侧「Choose Files」选择你的image.jpg文件
• 不要手动设置Content-Type：Postman会自动为form-data请求生成正确的multipart/form-data; boundary=xxx请求头，手动设置反而会导致解析失败

3. 额外排查项 #

如果上面两步都完成还是不行，可以检查：

• 确认项目Program.cs中已经启用静态文件中间件（app.UseStaticFiles();），因为你用到了WebRootPath
• 检查是否有全局拦截中间件或模型绑定配置，干扰了文件的解析逻辑
• 可以先简化代码，比如只返回fileStream?.FileName，确认文件能被接收后再逐步添加业务逻辑

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