IFormFile没有SaveAsAsync方法，需手动读取流并写入；FileName不可信，须重命名并校验Length和ContentType；大文件应直写磁盘或上传云存储，避免内存缓冲；安全防护需额外实现。
ASP.NET Core中IFormFile的常见错误：直接调用SaveAsAsync会失败
ASP.NET Core里IFormFile没有SaveAsAsync方法——这是从旧版ASP.NET MVC迁移过来的人最容易踩的坑。你看到编译报错'IFormFile' does not contain a definition for 'SaveAsAsync'，不是环境问题，是接口本身就不提供这个方法。
必须手动读取流并写入文件系统或存储服务。关键点在于：IFormFile只是一份“文件元数据+可读流”，不自动落地。
- 它不持有完整内存副本（除非显式
CopyToAsync到MemoryStream） -
FileName不可信，可能含路径遍历字符（如../../web.config） -
Length可能为0，需提前校验 - 流只能读一次，多次
CopyToAsync会抛ObjectDisposedException
安全保存文件的最小可行代码：验证+重命名+流复制
不要拼接file.FileName进物理路径。用Path.GetRandomFileName()生成唯一名，再保留扩展名；同时检查file.Length和file.ContentType（后者仅作参考，不能替代后端MIME检测）。
var uploadsRoot = Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "uploads");
Directory.CreateDirectory(uploadsRoot);
var extension = Path.GetExtension(file.FileName);
var newFileName = $"{Guid.NewGuid():N}{extension}";
var filePath = Path.Combine(uploadsRoot, newFileName);
using var stream = new FileStream(filePath, FileMode.Create);
await file.CopyToAsync(stream);
注意：file.OpenReadStream()返回的流无需Dispose——框架在请求结束时自动释放。但自己新建的FileStream必须用using确保关闭。
大文件上传时避免内存爆掉：用Stream管道直写磁盘
如果用户上传200MB视频，CopyToAsync默认缓冲区是81920字节，但若误用file.CopyToAsync(memoryStream)，整块读进内存就崩了。正确做法是绕过内存缓冲，让流直接落盘。
- 禁用模型绑定对大文件的自动加载：在
Startup.ConfigureServices加services.Configure<formoptions>(options => options.MultipartBodyLengthLimit = 524288000);</formoptions>（500MB） - 控制器参数保持
IFormFile，别转成byte[]或MemoryStream - 用
FileStream构造时指定FileOptions.Asynchronous | FileOptions.SequentialScan提升吞吐
保存到非本地路径（如Azure Blob、S3）：别先存本地再上传
生产环境通常不存Web服务器磁盘。直接把IFormFile.OpenReadStream()传给云SDK，避免中间落盘浪费IO和空间。
例如Azure Blob Storage：
var blobClient = _blobServiceClient.GetBlobContainerClient("uploads").GetBlobClient(newFileName);
await blobClient.UploadAsync(file.OpenReadStream(), new BlobHttpHeaders { ContentType = file.ContentType });
注意：UploadAsync会自行读取流并上传，无需额外CopyToAsync。但要确保file.OpenReadStream()返回的流未被其他逻辑提前读取过——否则位置已在末尾，上传结果为空。
真正难的不是怎么存，是怎么拒绝恶意文件：扩展名白名单、魔数校验、杀毒扫描集成、上传后异步转码/缩略——这些都不在IFormFile接口范围内，得自己补全。
