0

0

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

幻夢星雲

幻夢星雲

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

|

882人浏览过

|

来源于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.MemoryLimitFormOptions.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,检查 ContentDispositionFileName 字段,匹配目标文件字段名(如 "file"
  • 拿到对应 section 的 Body 流后,直接 await section.Body.CopyToAsync(outputStream) —— 这里 outputStream 可以是 FileStreamHttpClient.PostAsync 的请求体,或云存储 SDK 的上传流

MultipartReader 容易漏掉的坑

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

Descript
Descript

一个多功能的音频和视频编辑引擎

下载
  • 务必用 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 解决,得结合前端 fetchAbortController 和后端连接生命周期管理。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

952

2023.09.19

length函数用法
length函数用法

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

952

2023.09.19

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

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

332

2023.10.19

batoto漫画官网入口与网页版访问指南
batoto漫画官网入口与网页版访问指南

本专题系统整理batoto漫画官方网站最新可用入口,涵盖最新官网地址、网页版登录页面及防走失访问方式说明,帮助用户快速找到batoto漫画官方平台,稳定在线阅读各类漫画内容。

331

2026.02.25

Steam官网正版入口与注册登录指南_新手快速进入游戏平台方法
Steam官网正版入口与注册登录指南_新手快速进入游戏平台方法

本专题系统整理Steam官网最新可用入口,涵盖网页版登录地址、新用户注册流程、账号登录方法及官方游戏商店访问说明,帮助新手玩家快速进入Steam平台,完成注册登录并管理个人游戏库。

49

2026.02.25

TypeScript全栈项目架构与接口规范设计
TypeScript全栈项目架构与接口规范设计

本专题面向全栈开发者,系统讲解基于 TypeScript 构建前后端统一技术栈的工程化实践。内容涵盖项目分层设计、接口协议规范、类型共享机制、错误码体系设计、接口自动化生成与文档维护方案。通过完整项目示例,帮助开发者构建结构清晰、类型安全、易维护的现代全栈应用架构。

33

2026.02.25

Python数据处理流水线与ETL工程实战
Python数据处理流水线与ETL工程实战

本专题聚焦 Python 在数据工程场景下的实际应用,系统讲解 ETL 流程设计、数据抽取与清洗、批处理与增量处理方案,以及数据质量校验与异常处理机制。通过构建完整的数据处理流水线案例,帮助开发者掌握数据工程中的性能优化思路与工程化规范,为后续数据分析与机器学习提供稳定可靠的数据基础。

13

2026.02.25

Java领域驱动设计(DDD)与复杂业务建模实战
Java领域驱动设计(DDD)与复杂业务建模实战

本专题围绕 Java 在复杂业务系统中的建模与架构设计展开,深入讲解领域驱动设计(DDD)的核心思想与落地实践。内容涵盖领域划分、聚合根设计、限界上下文、领域事件、贫血模型与充血模型对比,并结合实际业务案例,讲解如何在 Spring 体系中实现可演进的领域模型架构,帮助开发者应对复杂业务带来的系统演化挑战。

5

2026.02.25

Golang 生态工具与框架:扩展开发能力
Golang 生态工具与框架:扩展开发能力

《Golang 生态工具与框架》系统梳理 Go 语言在实际工程中的主流工具链与框架选型思路,涵盖 Web 框架、RPC 通信、依赖管理、测试工具、代码生成与项目结构设计等内容。通过真实项目场景解析不同工具的适用边界与组合方式,帮助开发者构建高效、可维护的 Go 工程体系,并提升团队协作与交付效率。

19

2026.02.24

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 10.2万人学习

C 教程
C 教程

共75课时 | 5万人学习

C++教程
C++教程

共115课时 | 19.5万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号