使用System.Net.Http.StreamContent发送数据时，为何会忽略指定的缓冲区大小，将整个流读取到内存中？

你遇到的这个问题确实很容易踩坑——明明给StreamContent指定了50KB的缓冲区，但它却直接把整个2GB的流全读到内存里才发请求，完全没用到缓冲区。我来给你拆解下原因和解决办法：

为什么缓冲区被忽略了？ #

核心原因是**StreamContent默认会尝试提前计算请求的Content-Length**：

• 如果你的流支持Seek（比如本地文件的FileStream），并且能获取到Length属性，那它会直接用这个值作为Content-Length，这时候会乖乖用你设置的缓冲区分块读取发送。
• 但如果你的流是不可Seek的（比如网络流、未设置可Seek的内存流，或者自定义流），StreamContent为了拿到总长度，就会把整个流的数据先读到内存缓冲区里，这时候你设置的50KB缓冲区自然就被忽略了。

解决办法：启用分块传输编码 #

要让StreamContent真正按你设置的缓冲区大小分块发送，关键是跳过Content-Length的计算，启用分块传输编码。只需要给StreamContent添加一行配置即可：

using (var httpClient = new HttpClient())
{
    using (var content = new StreamContent(stream, 1024 * 50)) // 50 KB buffer size 现在会生效了
    {
        // 启用分块传输编码，不用提前计算Content-Length
        content.Headers.TransferEncodingChunked = true;
        
        using (var request = new HttpRequestMessage(HttpMethod.Post, requestUri))
        {
            request.Content = content;
            await httpClient.SendAsync(request);
        }
    }
}

额外说明 #

• 分块传输编码（Transfer-Encoding: chunked）是HTTP标准的一部分，现在绝大多数服务器都支持，不用担心兼容性问题。
• 如果你的流本身支持Seek和Length，其实不需要启用分块，StreamContent会自动按缓冲区分块发送；但如果是不可Seek的流，分块是避免内存溢出的唯一办法。
• 另外，如果你不想用分块，也可以手动计算流的长度并设置Content-Length头，但这前提是你能提前知道流的总大小，否则还是得用分块。

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