ASP.NET Core 上传大文件需同时配置 IIS 最大请求体和控制器级 RequestSizeLimit；断点续传依赖服务端维护已上传字节数并校验唯一 ID；下载须流式处理避免内存溢出；合并分块需按序拼接并保证原子性。
WebAPI 上传大文件时 IFormFile 直接报错或截断
ASP.NET Core 默认限制单个请求体大小为 30MB，超过就直接 400 或连接重置，根本进不到控制器逻辑。不是代码写错了，是管道在模型绑定前就拦下了。
必须同时改两处配置：
-
Startup.cs（.NET 5+ 在Program.cs）里加ConfigureServices配置：services.Configure<IISOptions>(options => options.MaxRequestBodySize = null);
（仅 IIS） - 全局或控制器级加
[RequestSizeLimit(200_000_000)]或更宽松的值（单位字节），且需确保中间件顺序在UseRouting之后、UseEndpoints之前 - 前端
fetch或axios发送时别用FormData拼错字段名——后端[FromForm] IFormFile file绑定的字段名必须和表单中append("file", blob)的第一个参数完全一致
断点续传核心：怎么判断文件块是否已存在并跳过
关键不在“传”，而在“查”。每次上传前客户端必须先发一个 HEAD 或 GET 请求，带 Range 和文件唯一标识（如 Content-MD5 或自定义 X-Upload-ID），服务端根据这个 ID 查本地临时目录或数据库，返回已接收的字节数（206 Partial Content + Content-Range）或 200 OK 表示全新上传。
不要依赖客户端传来的“当前 offset”，它可能伪造或错位；服务端必须自己维护每个 X-Upload-ID 对应的已写入长度：
- 用
ConcurrentDictionary<string long></string>存 ID → 已写大小（开发期够用，生产建议换 Redis） - 写文件时用
FileStream构造函数指定FileMode.Append，但注意：必须先Seek到指定位置再写，否则会追加在末尾，破坏分块顺序 - 客户端收到
206后，从Content-Range解析出bytes 0-1048575/2097152中的1048576，作为下一块的起始偏移
HttpClient 下载大文件卡死或内存爆掉
别用 response.Content.ReadAsStringAsync() 或 ReadAsByteArrayAsync()——这是把整个文件读进内存，1GB 文件直接 OOM。下载必须流式处理。
正确做法是拿到 HttpContent.ReadAsStreamAsync() 后，用 Stream.CopyToAsync() 直接写入本地文件流：
using var stream = await response.Content.ReadAsStreamAsync(); using var file = File.Create(@"C:\temp\big.zip"); await stream.CopyToAsync(file);
注意两个坑：
-
HttpClient实例要复用（静态或 DI 注入），不能每次 new，否则 socket 耗尽 - 如果需要进度回调，别用
CopyToAsync，改用循环ReadAsync+WriteAsync，每次读 8192 字节并更新 UI - 下载中途取消？传
cancellationToken给ReadAsStreamAsync和CopyToAsync，它们都支持
合并分块时 FileStream 写入顺序错乱或损坏
分块上传完毕后，客户端发合并请求，服务端按序号（chunkIndex）读取所有临时块文件，顺序拼接。最容易被忽略的是：块文件名不能只靠序号，还得带上传 ID，否则并发上传同名文件会互相覆盖。
合并逻辑本身很简单，但必须保证原子性：
- 临时块路径格式建议：
Path.Combine(tempDir, uploadId, $"chunk_{index:D6}") - 合并前检查所有块是否存在且大小匹配（比如每块固定 5MB，最后一块可小）
- 用
File.OpenWrite()创建目标文件，再逐个File.OpenRead()块文件，CopyTo进去——别用AppendAllBytes，它每次打开文件都会 seek 到末尾，但多线程下不可靠 - 合并成功后，立刻删临时目录（
Directory.Delete(tempPath, true)），失败则留着供重试，别自动清理
真正的复杂点在于：上传 ID 的生成必须全局唯一且无状态（比如用 Guid.NewGuid().ToString("N")），而不能依赖 Session 或内存变量——负载均衡下请求可能打到不同机器。
