讲师中心 微信公众号
AI工具推荐 视频效率加速

C#流式上传文件 C#如何在不加载到内存的情况下处理大文件上传

小伟同学_8162

小伟同学_8162

发布时间:2026-02-26 10:58:02

|

902人浏览过

|

来源于php中文网

原创

ASP.NET Core 的 Request.Form.Files 默认将大文件全载入内存,因其依赖 MultipartReader 且默认启用缓冲;需禁用自动模型绑定、设置 DisableMultipartBuffering = true,并用 MultipartReader 流式解析 multipart 数据边读边转存。

c#流式上传文件 c#如何在不加载到内存的情况下处理大文件上传

为什么 Request.Form.Files 会把大文件全塞进内存

ASP.NET Core 默认用 FormFile 处理上传,它底层依赖 MultipartReader,但一旦调用 file.OpenReadStream() 或 file.CopyToAsync(),框架就会把整个文件先缓存到内存(或临时磁盘),取决于 WebHostOptions.MemoryLimit 和 FormOptions.MultipartBodyLengthLimit 设置。这不是你代码写得不对,是默认行为本身就不适合 GB 级文件。

用 HttpContext.Request.Body 直接流式读取原始 multipart 数据

绕过 IFormFile,自己解析 multipart boundary,边读边转存。关键点:必须禁用自动模型绑定、关闭缓冲、手动控制读取节奏。

  • 在 Startup.ConfigureServices 中设 options.DisableMultipartBuffering = true
  • Controller 方法参数去掉 [FromForm],改用 HttpContext 入参
  • 检查 Request.ContentType 是否以 "multipart/form-data" 开头,并提取 boundary
  • 用 new MultipartReader(boundary, Request.Body) 创建读取器,逐段调用 ReadNextSectionAsync()
  • 对每个 section,检查 ContentDisposition 的 FileName 字段,匹配目标文件字段名(如 "file")
  • 拿到对应 section 的 Body 流后,直接 await section.Body.CopyToAsync(outputStream) —— 这里 outputStream 可以是 FileStream、HttpClient.PostAsync 的请求体,或云存储 SDK 的上传流

MultipartReader 容易漏掉的坑

它不自动跳过 preamble(boundary 前的空白),也不校验 header 编码,出错时异常信息极简,常表现为 InvalidDataException 或静默截断。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载
  • 务必用 Request.Headers["Content-Length"] 校验总长度,防止客户端传一半就断连
  • 设置 Request.EnableBuffering() 仅在调试时临时开启,上线必须关 —— 否则又回到内存加载老路
  • boundary 要从 ContentType 中安全提取:MediaTypeHeaderValue.Parse(Request.ContentType).Parameters.FirstOrDefault(p => p.Name.Equals("boundary", StringComparison.OrdinalIgnoreCase))?.Value
  • 不要用 StreamReader 读 section body —— 它是二进制文件,不是文本;必须用 Stream 原始读取

上传到云存储(如 Azure Blob / AWS S3)时怎么保持流式

核心是别把文件落地本地磁盘,而是让 MultipartReader 解出的 section.Body 直接作为上传 SDK 的输入流。多数 SDK 支持流式上传,但注意超时和分块策略。

  • Azure Blob:用 BlobClient.UploadAsync(stream, new BlobHttpHeaders { ContentType = "application/octet-stream" }),内部会自动分块,无需你处理
  • AWS S3:PutObjectRequest.InputStream = section.Body,但需确保 AutoCloseStream = false,否则 SDK 关闭流会导致后续 section 读取出错
  • 若目标服务不支持流式(如某些旧版 FTP),只能落地临时文件 + FileStream 分块读取 + 手动删除,此时至少避免一次性 ReadAllBytes

真正难的不是“怎么读”,而是边界条件:网络中断时如何续传、并发上传多个大文件时如何限流、用户取消上传时如何及时释放连接。这些没法靠一个 MultipartReader 解决,得结合前端 fetch 的 AbortController 和后端连接生命周期管理。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

更多
length函数用法
length函数用法

length函数用于返回指定字符串的字符数或字节数。可以用于计算字符串的长度,以便在查询和处理字符串数据时进行操作和判断。 需要注意的是length函数计算的是字符串的字符数,而不是字节数。对于多字节字符集,一个字符可能由多个字节组成。因此,length函数在计算字符串长度时会将多字节字符作为一个字符来计算。更多关于length函数的用法,大家可以阅读本专题下面的文章。

1847

2023.09.19

cdn加速软件有哪些
cdn加速软件有哪些

CDN加速软件可以帮助网站提高内容访问速度和用户体验,降低服务器负载。在选择CDN加速软件时,需要根据实际需求和预算进行权衡,选择合适的软件和服务商。cdn加速软件有AWS CloudFront、Azure Content Delivery Network、Google Cloud CDN、Fastly、Cloudflare和Incapsula。

3547

2023.10.19

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

60

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

40

2026.10.16

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

40

2026.10.16

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

20

2026.10.16

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

20

2026.10.16

Revel框架入门与安装配置
Revel框架入门与安装配置

本专题从Revel框架环境搭建讲起,系统介绍命令行工具安装、项目创建、目录结构、配置文件及热代码重载,帮助开发者快速完成首个Go Web应用。

20

2026.10.16

Linux 新手先学哪些命令
Linux 新手先学哪些命令

Linux新手命令专题汇集终端基础、文件目录操作、文本查看、软件安装和权限管理等入门文章,帮助按实际任务练习常用命令并建立命令行操作习惯。

40

2026.10.15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn