iformfile 为 null 的主因是前端未用 multipart/form-data 表单格式发送请求：需禁用手动设置 content-type，使用 formdata 并确保键名与后端参数/属性名严格一致，同时配置请求大小限制、校验文件合法性、安全保存并返回可访问路径。
WebAPI 用 IFormFile 接收图片，必须用 POST + multipart/form-data，不能走 JSON body，否则文件字段为空。
为什么 IFormFile 总是 null？
最常见原因是前端没按表单格式发请求：用 fetch 或 axios 时手动设了 Content-Type（比如 application/json），浏览器就自动丢弃了 multipart 边界信息，后端收不到文件字段。
- 前端必须让浏览器自动生成
Content-Type：不手动设置，直接传FormData对象 - 后端 Action 参数名（如
file）必须和前端FormData.append("file", ...)的 key 完全一致（区分大小写） - 如果用了模型绑定（如
MyUploadModel model），确保该类里IFormFile属性名也匹配字段名，且属性有public访问修饰符 - ASP.NET Core 默认限制单个文件 128 MB、整个请求 134 MB，超限会静默失败（
IFormFile为 null），需在Startup.cs或Program.cs配置ConfigureFormOptions
IFormFile 要怎么读取和保存？
别直接调 file.OpenReadStream() 后用 CopyTo 写文件——流可能未缓冲，大文件易出错；推荐用 CopyToAsync + 显式检查 file.Length 防空文件。
- 先校验
file.Length > 0，再检查file.ContentType是否在允许列表内（如"image/jpeg"、"image/png"） - 生成安全文件名：用
Path.GetRandomFileName()+ 保留扩展名，不要直接用file.FileName - 保存路径建议用
Path.Combine(Directory.GetCurrentDirectory(), "wwwroot", "uploads", safeName)，避免路径遍历 - 用
using var stream = file.OpenReadStream();+await stream.CopyToAsync(fileStream)，别用同步 I/O
如何支持多图上传？
不是把多个 IFormFile 写成多个参数，而是用 IFormFileCollection 或 IEnumerable<iformfile></iformfile> 接收同名字段。
- 前端
FormData.append("files", file1); FormData.append("files", file2);（key 相同） - 后端参数写成
IFormFileCollection files或IEnumerable<iformfile> files</iformfile> - 注意：每个
IFormFile的FileName是原始名，但内容独立，可分别校验和保存 - 若混传文本字段（如
title），需额外加字符串参数，或统一用模型绑定（模型中含string Title和IFormFileCollection Files）
上传后返回什么才实用？
别只返回 Ok() 或硬编码 URL。客户端需要真实可访问的路径或相对地址，且要防跨域和部署路径变化。
- 用
Url.Content($"~/uploads/{safeName}")生成相对路径（如/uploads/abc.jpg），前端拼到基础 URL 上更可靠 - 如果 API 和静态资源不在同一域名，返回完整 HTTPS 地址（用
Request.Scheme + "://" + Request.Host + "/uploads/..."） - 务必检查文件是否真写入成功（
File.Exists(filePath)），再返回结果，否则前端以为上传成功，实际磁盘无文件 - 上传失败时，返回明确状态码（如
BadRequest("文件类型不支持")）和具体错误，别吞异常
真正卡住人的往往不是语法，而是 FormData 构造方式、中间件顺序（如 UseStaticFiles 必须在 UseRouting 之后）、以及上传后路径生成逻辑——这些地方一错，前端看着请求成功，后端却连文件影子都摸不到。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
