.NET 8使用HttpClient上传文件遇阻：请求构建存在哪些疏漏？

问题背景 #

原.NET 4.6.2使用ApiWebClient上传文件的实现：

var webClient = new ApiWebClient();
webClient.Timeout = timeout;

webClient.Headers.Add( HttpHeaderNames.CONTENT_TYPE, contentType );
webClient.Headers.Add( HttpHeaderNames.CONTENT_DISPOSITION, disp );

foreach (var h in _headers)
     webClient.Headers.Add(h.Key, h.Value);

respBytes = webClient.UploadFile(FullUrl, fileFullPath);

迁移到.NET 8使用HttpClient时，服务器返回未附加文件，当前实现代码：

var httpClient = GetHttpClient(); // gets from the HttpClientFactory
httpClient.Timeout = new TimeSpan( 0, 0, timeout );

var uriBuilder = BuildUriWithGets();
var req = new HttpRequestMessage( HttpVerb, uriBuilder.ToString() );
req.Headers.TryAddWithoutValidation( HttpHeaderNames.CONTENT_TYPE, contentType );
req.Headers.TryAddWithoutValidation( HttpHeaderNames.CONTENT_DISPOSITION, disp );

foreach (var h in _headers)
    request.Headers.TryAddWithoutValidation(h.Key, h.Value);

HttpResponseMessage resp;

using var requestContent = new MultipartFormDataContent();
using var fileStream = File.OpenRead(fileFullPath);

requestContent.Add(new StreamContent(fileStream));
req.Content = requestContent;

resp = httpClient.Send(req);

代码修正 #

你的实现存在几个关键问题，以下是正确的上传方式：

1. Content-Type和Content-Disposition不能直接加在请求头：MultipartFormDataContent会自动生成正确的Content-Type（包含boundary），而文件的Content-Disposition需要在添加文件时单独指定。
2. 必须指定文件参数名：添加StreamContent时要明确指定参数名为"file"，同时建议设置文件名。
3. 变量名错误：循环中使用了未定义的request变量，应该改为req。

修正后的代码：

var httpClient = GetHttpClient();
httpClient.Timeout = TimeSpan.FromSeconds(timeout);

var uriBuilder = BuildUriWithGets();
var req = new HttpRequestMessage(HttpVerb, uriBuilder.ToString());

// 自定义请求头添加到请求Headers（注意不要加Content-Type/Content-Disposition）
foreach (var h in _headers)
{
    req.Headers.TryAddWithoutValidation(h.Key, h.Value);
}

using var requestContent = new MultipartFormDataContent();
using var fileStream = File.OpenRead(fileFullPath);
// 指定参数名为"file"，并设置文件名
var fileContent = new StreamContent(fileStream);
// 可选：设置文件的Content-Type，比如根据文件类型自动获取
fileContent.Headers.ContentType = new MediaTypeHeaderValue(contentType);
requestContent.Add(fileContent, "file", Path.GetFileName(fileFullPath));

req.Content = requestContent;

var resp = httpClient.Send(req);

查看原始请求报文的方法 #

方法1：Visual Studio日志输出 #

在appsettings.json中添加日志配置，开启HttpClient的详细日志：

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "System.Net.Http": "Debug"
    }
  }
}

运行程序后，在Visual Studio的输出窗口（选择"显示来自：调试"）中可以看到完整的请求头、内容边界和文件数据的日志。

方法2：使用DelegatingHandler拦截请求 #

自定义一个Handler来打印原始请求内容：

public class LoggingHandler : DelegatingHandler
{
    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        // 打印请求头
        Console.WriteLine($"Request Method: {request.Method}");
        Console.WriteLine($"Request URI: {request.RequestUri}");
        Console.WriteLine("Request Headers:");
        foreach (var header in request.Headers)
        {
            Console.WriteLine($"{header.Key}: {string.Join(", ", header.Value)}");
        }

        // 打印请求内容（仅针对Multipart类型）
        if (request.Content != null)
        {
            Console.WriteLine("Request Content:");
            var content = await request.Content.ReadAsStringAsync(cancellationToken);
            Console.WriteLine(content);
        }

        return await base.SendAsync(request, cancellationToken);
    }
}

注册HttpClient时添加这个Handler：

services.AddHttpClient("FileUploadClient")
        .AddHttpMessageHandler<LoggingHandler>();

运行时控制台会输出完整的请求报文。

方法3：Fiddler抓包 #

启动Fiddler后，让.NET程序通过Fiddler代理（默认代理地址http://localhost:8888），可以直接查看原始的HTTP请求报文，包括所有头和内容。

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