C# Web API接收IFormFile为null的问题求助

咱们先把导致问题的两个核心点揪出来，逐个解决就能搞定啦：

1. 先修正属性名不匹配的低级错误 #

你看你的PrintFile模型类里，文件属性叫File，但在API的Print方法里，你调用的却是printDocument.Document——这俩名字对不上啊！模型绑定的时候找不到Document这个属性，文件自然就成null了。

先把这里改一致，比如把API里的调用改成：

var response = _printingService.PrintFile(printDocument.File, printDocument.PrinterName, printDocument.ServerName);

或者把模型类的属性名改成Document，只要两边保持统一就行。

2. 关键问题：文件上传不能用JSON格式传递 #

IFormFile是ASP.NET专门用来处理multipart/form-data类型请求的文件上传对象，你客户端用AddJsonBody把数据序列成JSON发送，这种格式根本没法正确解析出IFormFile，这才是核心问题。咱们得把请求改成multipart/form-data格式：

步骤一：修改API的参数绑定 #

把[FromBody]特性去掉，因为multipart/form-data请求不需要这个，ASP.NET会自动处理模型绑定：

[Route("print")]
[HttpPost]
public IHttpActionResult Print(PrintFile printDocument) // 移除[FromBody]
{
    try
    {
        if (ModelState.IsValid)
        {
            // 注意这里用printDocument.File，和模型属性一致
            var response = _printingService.PrintFile(printDocument.File, printDocument.PrinterName, printDocument.ServerName);
            return Ok(response);
        }
        else
        {
            // 这里建议返回BadRequest而不是Unauthorized，ModelState无效不是权限问题
            return BadRequest(ModelState); 
        }
    }
    catch (Exception ex)
    {
        return BadRequest(string.Format(ErrorMessages.GeneralErrorMsg, ex.Message));
    }
}

步骤二：修改客户端的请求发送方式 #

客户端不能再用AddJsonBody，而是要用AddFile和AddParameter来构建multipart/form-data请求，修改后的代码如下：

public ResponseData PrintFile(PrintFileInfo printFileInfo)
{
    try
    {
        _request = new RestRequest(ResourceNames.Print, Method.POST);
        // 强制使用multipart/form-data格式
        _request.AlwaysMultipartFormData = true;

        // 添加普通文本参数
        _request.AddParameter("PrinterName", printFileInfo.PrinterName);
        _request.AddParameter("ServerName", printFileInfo.ServerName);

        // 添加文件参数，注意参数名要和模型里的属性名完全一致（这里是"File"）
        if (printFileInfo.File != null)
        {
            _request.AddFile("File", 
                () => printFileInfo.File.OpenReadStream(), 
                printFileInfo.File.FileName);
        }

        // 如果有Parameters字典，逐个添加键值对
        if (printFileInfo.Parameters != null)
        {
            foreach (var kvp in printFileInfo.Parameters)
            {
                _request.AddParameter($"Parameters[{kvp.Key}]", kvp.Value);
            }
        }

        var response = _client.Execute(_request);
        var responseData = new ResponseData()
        {
            ResponseCode = response.StatusCode.ToString(),
            ResponseBody = response.Content
        };
        return responseData;
    }
    catch (Exception ex)
    {
        _logger.Error(ex, string.Format(ErrorMessages.ResourceException, ResourceNames.Print));
        throw;
    }
}

额外调试小贴士 #

• 如果还是有问题，可以在API里打印ModelState.Values的错误信息，能帮你快速定位绑定失败的原因。
• 确保客户端的PrintFileInfo类能正确获取到文件流，比如从本地读取文件时路径要正确，流能正常打开。

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