ASP.NET Core文件上传Postman调用报415 Unsupported Media Type如何解决
415 Unsupported Media Type 问题解决方法
问题核心原因
这个错误的本质是当前Postman发送的请求媒体类型,和后端接口的输入绑定规则不匹配,框架没有找到能解析当前请求内容的输入格式化器,所以直接返回415状态码。你的接口本身设计用来接收multipart/form-data格式的表单提交,同时绑定普通模型字段和上传文件,常见触发场景是Postman请求配置不对、后端绑定特性缺失。
具体解决步骤
修正Postman请求体配置
- 打开Postman的请求体(Body)配置页,不要选择
raw(JSON格式)或者x-www-form-urlencoded选项,必须选择form-data选项 - 在form-data的键值对列表里,分别添加两类字段:
- 普通文本字段:键名严格对应
Event模型的属性名Id、Name,值填写你要提交的业务数据 - 文件字段:键名必须和后端接口的文件参数名完全一致,即
file,字段类型从默认的Text切换为File,选中你要上传的本地图片文件
- 普通文本字段:键名严格对应
- 不要手动修改请求头里的
Content-Type配置:Postman选择form-data模式时,会自动生成带正确boundary分隔符的multipart/form-data请求头,手动硬写Content-Type(尤其是漏掉boundary参数)会直接触发415错误。如果之前选JSON模式时留下了Content-Type: application/json的自定义头,要把这行删掉。
- 打开Postman的请求体(Body)配置页,不要选择
补充后端模型绑定特性
ASP.NET Core默认对接口的复杂对象参数,不一定会自动按表单格式绑定,需要显式标注从表单取值,避免框架默认匹配JSON格式化器导致的识别失败。你可以给接口的Event模型参数加上[FromForm]特性,修改后的接口签名如下:[HttpPost] public ActionResult<Models.Event> CreateEvent([FromForm] Models.Event events, IFormFile file) { // 原有业务逻辑保持不变 }排查容易遗漏的配置项
- 表单内的字段名必须和模型属性、接口参数名大小写完全一致,比如文件字段名错写为
File、模型字段名错写为eventName而不是Name,都会导致绑定失效 - 确认项目没有在服务配置里移除表单输入的支持:默认新建的ASP.NET Core Web API项目会默认开启表单绑定,如果之前手动配置过仅支持JSON格式化器,需要把表单绑定的能力重新打开。
- 表单内的字段名必须和模型属性、接口参数名大小写完全一致,比如文件字段名错写为
注意:你当前接口里把文件直接存在wwwroot根目录、生成的图片DB路径没有拼接斜杠、图片处理后没有释放资源的问题是后续优化点,不会直接触发当前的415错误。
内容的提问来源于stack exchange,提问作者LongLong
相关产品推荐
相关产品推荐

