You need to enable JavaScript to run this app. ASP.NET Core文件上传Postman调用报415 Unsupported Media Type如何解决
优惠活动
大模型
产品
解决方案
定价
更多

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的自定义头,要把这行删掉。
  • 补充后端模型绑定特性
    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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 09:13:45