Document Upload API在Postman正常但.NET代码调用失败，求排查方案

问题描述 #

我通过.NET WebApi向某服务上传文档，该服务接收包含两部分的multipart/form-data请求：第一部分为JSON数据，第二部分为文件。该API在Postman中可正常调用，但将Postman生成的C# HttpClient代码复制到应用后，调用时出现500错误，且使用的文件和JSON数据与Postman中完全一致。

我的代码如下：

string url = "Some url";//leaving out the actual url here
string token = GetToken();//invoke separate method to get an Oauth2 token - confirmed that this is working
System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12 | SecurityProtocolType.Tls11 | SecurityProtocolType.Tls;//tried with and without this line
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, serviceUrl);
client.Timeout = TimeSpan.FromSeconds(30);
request.Headers.Add("Authorization", "Bearer " + token);
request.Headers.Host = "destinationurl.com";//leaving out the actual url here.
var content = new MultiPartFormDataContent();
content.Add(new StringContent(JsonSerializer.Serialize(my_object), Encoding.UTF8, "application/json"), "keywords");
var streamContent = new StreamContent(File.OpenRead(path_to_file));
streamContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue("application/pdf");
content.Add(streamContent, "proposalFile", path);
request.Content = content;
var response = await client.SendAsync(request);
string responseString = await response.Content.ReadAsStringAsync();
response.EnsureSuccessStatusCode();

调用的服务内部会请求另一服务，返回的错误信息为“post on the internal service failed 500”，偶尔还会出现“Exception while consuming stream”异常。

可能的问题排查 #

1. 文件流未正确释放 #

File.OpenRead打开的文件流如果没及时释放，可能导致流读取不完整或被占用，触发服务端的流解析异常。Postman会自动处理流生命周期，自己代码里要用using包裹确保释放：

using var fileStream = File.OpenRead(path_to_file);
var streamContent = new StreamContent(fileStream);

2. Multipart边界不匹配 #

Postman会生成特定的边界字符串，而MultipartFormDataContent默认生成的边界可能和服务端预期不符。抓Postman请求的Content-Type头（比如multipart/form-data; boundary=----WebKitFormBoundaryxxxx），手动指定边界：

var boundary = "----WebKitFormBoundary7MA4YWxkTrZu0gW"; // 替换成Postman里的实际边界
var content = new MultipartFormDataContent(boundary);

3. JSON格式/编码差异 #

JsonSerializer.Serialize生成的JSON可能和Postman里的有细微差别（比如缩进、属性大小写），服务端可能对格式敏感。对比Postman的JSON内容，调整序列化选项：

var options = new JsonSerializerOptions 
{ 
    WriteIndented = false, // 和Postman保持一致，不要缩进
    PropertyNamingPolicy = JsonNamingPolicy.CamelCase // 如果Postman用小驼峰
};
content.Add(new StringContent(JsonSerializer.Serialize(my_object, options), Encoding.UTF8, "application/json"), "keywords");

4. 手动设置Host头导致冲突 #

手动指定request.Headers.Host可能和实际请求的URL主机不一致，Postman一般不会手动设置这个头，尝试注释掉该行：

// request.Headers.Host = "destinationurl.com"; // 去掉手动设置，让HttpClient自动处理

5. HttpClient实例频繁创建 #

每次新建HttpClient会导致连接池资源耗尽，建议全局复用一个实例（比如单例模式）：

// 全局定义，复用同一个HttpClient
private static readonly HttpClient _sharedClient = new HttpClient();

// 方法内直接使用_sharedClient
var request = new HttpRequestMessage(HttpMethod.Post, serviceUrl);
// ... 其他设置
var response = await _sharedClient.SendAsync(request);

替代调用方式建议 #

1. 使用RestSharp简化请求 #

RestSharp封装了multipart请求的细节，减少手动处理的出错概率：

var client = new RestClient(serviceUrl);
var request = new RestRequest(Method.Post);
request.AddHeader("Authorization", $"Bearer {token}");
// 添加JSON参数
request.AddParameter("keywords", JsonSerializer.Serialize(my_object), "application/json", ParameterType.RequestBody);
// 添加文件
request.AddFile("proposalFile", path_to_file, "application/pdf");

var response = await client.ExecuteAsync(request);
if (!response.IsSuccessful)
{
    // 处理错误逻辑，比如打印response.Content
}

2. 抓包对比请求细节 #

用Fiddler或Charles分别抓Postman和自己代码的请求，对比以下内容找差异：

• 请求头的所有字段（比如Content-Length、User-Agent）
• Multipart表单的边界、字段引号、大小写
• 文件部分的Content-Disposition和Content-Type
• JSON字符串的编码和格式

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