如何在.NET Core应用中调用文件上传WebAPI？上传文件及数据失败

常见问题点及修复方案 #

1. 文件名与Content-Disposition格式错误 #

添加文件时需确保ContentDisposition格式符合规范，尤其是文件名的引号和编码，避免特殊字符或中文导致解析失败：

var fileContent = new StreamContent(fileStream);
// 匹配实际文件的MIME类型，比如image/jpeg、image/png
fileContent.Headers.ContentType = MediaTypeHeaderValue.Parse("image/png");
fileContent.Headers.ContentDisposition = new ContentDispositionHeaderValue("form-data")
{
    Name = "\"file\"", // 需与服务端接收参数名一致，比如服务端是IFormFile file，则这里是"file"
    FileName = $"\"{Path.GetFileName(filePath)}\"" // 文件名需用双引号包裹
};

2. 手动设置边界导致解析失败 #

不要手动指定MultipartFormDataContent的边界，让系统自动生成即可，否则容易和服务端解析的边界不匹配：

// 正确做法：不设置边界，由框架自动生成
using var multipartContent = new MultipartFormDataContent();
// 错误做法：避免手动指定边界
// var multipartContent = new MultipartFormDataContent("custom-boundary");

3. 附加表单数据格式错误 #

添加额外字段时需用StringContent，并确保键名格式正确：

// 添加文本字段，键名需与服务端接收的参数名一致
multipartContent.Add(new StringContent("测试内容"), "description");
multipartContent.Add(new StringContent("1"), "typeId");

4. 请求超时未配置 #

文件上传耗时较长，需给HttpClient设置合理的超时时间：

_httpClient.Timeout = TimeSpan.FromMinutes(5);

完整修正示例代码 #

using var multipartContent = new MultipartFormDataContent();
var filePath = "your-image-path.png";

// 读取文件并添加到多部分内容
using var fileStream = new FileStream(filePath, FileMode.Open, FileAccess.Read);
var fileContent = new StreamContent(fileStream);
fileContent.Headers.ContentType = MediaTypeHeaderValue.Parse("image/png");
fileContent.Headers.ContentDisposition = new ContentDispositionHeaderValue("form-data")
{
    Name = "\"file\"",
    FileName = $"\"{Path.GetFileName(filePath)}\""
};
multipartContent.Add(fileContent);

// 添加额外表单字段
multipartContent.Add(new StringContent("用户头像"), "title");
multipartContent.Add(new StringContent("2"), "categoryId");

// 发送请求并处理响应
var response = await _httpClient.PostAsync("api/upload", multipartContent);
// 抛出非2xx状态码的异常，便于排查错误
response.EnsureSuccessStatusCode();
var responseResult = await response.Content.ReadAsStringAsync();

排查步骤 #

• 抓包查看请求结构，确认多部分数据的边界、文件名、表单字段是否符合规范。
• 检查服务端接口：是否添加[FromForm]特性，参数名是否与客户端一致，比如服务端方法签名应为public IActionResult Upload([FromForm]IFormFile file, [FromForm]string title)。
• 确认文件路径正确，程序有读取文件的权限。
• 确保文件流未被提前关闭，使用using包裹流对象是正确做法。

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