IFormFile为null主因是未启用multipart/form-data绑定：需加[FromForm]标记参数，配置Kestrel请求体大小限制，并确保前端enctype="multipart/form-data"。
WebAPI接收IFormFile时为什么总是null
因为默认不支持 multipart/form-data 解析，apicontroller 不会自动绑定 iformfile，必须显式启用模型绑定支持。常见错误是直接在参数里写 iformfile file 却没加 [fromform]，或者忘了配置 kestrel 的请求体大小限制。
- 必须用
[FromForm]标记参数：[FromForm] IFormFile file - 检查
Startup.cs或Program.cs中是否调用services.AddControllers()（而非仅AddMvc()），后者在 .NET 6+ 已不推荐用于纯 API 场景 - Kestrel 默认限制请求体为 128MB，超限会静默失败或返回 400；需在
Program.cs配置：options.Limits.MaxRequestBodySize = 100 * 1024 * 1024; - 若用 Nginx/Apache 做反向代理，还要单独配置其上传限制（如 Nginx 的
client_max_body_size）
保存IFormFile到磁盘的正确姿势
别直接 file.CopyToAsync(stream) 写进 wwwroot —— 这会绕过所有权限控制和路径校验，还可能被恶意文件名攻击（比如 ../../../web.config）。核心原则：重命名 + 白名单校验 + 安全路径拼接。
- 用
Path.GetRandomFileName()生成新文件名，保留扩展名但只取白名单内的：var ext = Path.GetExtension(file.FileName).ToLowerInvariant(); if (!new[] { ".jpg", ".png", ".pdf" }.Contains(ext)) throw new InvalidOperationException("不支持的文件类型"); - 绝对不要拼接原始
file.FileName到路径里；用Path.Combine(uploadRoot, newFileName)，其中uploadRoot是预设的绝对路径（如_env.WebRootPath + "/uploads"） - 写入前确保目录存在：
Directory.CreateDirectory(Path.GetDirectoryName(filePath)); - 异步写入更稳妥：
await using var stream = new FileStream(filePath, FileMode.Create); await file.CopyToAsync(stream);
一次性上传多个文件怎么处理
IFormFileCollection 不是数组，不能靠索引安全访问；它底层是只读集合，且每个 IFormFile 的 OpenReadStream() 只能调用一次。常见坑是循环里反复调用 OpenReadStream() 导致后续读取为空。
- 参数声明为：
[FromForm] IList<iformfile> files</iformfile>或[FromForm] IFormFileCollection files - 遍历前先检查
files?.Any() == true，避免空引用 - 每个文件要独立打开流：
await using var stream = file.OpenReadStream();，别复用同一个 stream 变量 - 如果需要多次读取（比如先校验再保存），得把内容读进
MemoryStream缓存，但要注意大文件内存压力
前端传文件时后端收不到name字段
HTML 表单里 <input type="file"> 的 name 属性值，就是后端 [FromForm] 参数的绑定依据。很多人把 name="avatar" 写成 name="model.Avatar" 或漏写 name，导致绑定失败。
- 确保前端
<input name="file" type="file">和后端参数名一致：[FromForm] IFormFile file - 如果传多个同名文件（如多选上传），浏览器会自动按 name 分组，后端用
IList<IFormFile>接收即可 - 额外字段（如
<input name="userId">）也必须加[FromForm]，且类型匹配（int、string等） - 别用
application/json方式发文件 —— JSON 无法嵌入二进制，必须用multipart/form-data
最常被忽略的是 Kestrel 的 MaxRequestBodySize 和前端表单的 enctype="multipart/form-data" 缺一不可；少一个，IFormFile 就是 null，而且连错误日志都不明显。
