You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

ASP.NET Core Web API GET请求返回Unsupported Media Type错误求解

问题原因分析
  • 问题的核心是[ApiController]特性的默认绑定规则和传统ASP.NET MVC5不同:标注了[ApiController]的控制器,复杂类型参数默认会从请求体([FromBody])绑定,不会自动匹配查询字符串参数。
  • GET请求的标准参数传递位置是查询字符串,正常不会携带请求体,框架尝试读取请求体时找不到符合要求的内容,就会返回415 Unsupported Media Type错误。你给GET请求添加JSON请求体时符合[FromBody]的绑定要求,所以能正常响应,刚好验证了这个默认规则的存在。
  • 你在模型类上添加的[BindProperties(SupportsGet = true)]特性仅对未标注[ApiController]的传统MVC控制器、Razor Pages生效,ApiController的绑定源推断优先级更高,所以这个配置不会生效。
解决方案

你已经用的显式加[FromQuery]特性是最推荐的方案,绑定规则清晰,符合REST规范。如果需要适配类似MVC5的默认绑定逻辑,可以选择以下方式:

  1. 关闭ApiController的自动绑定源推断,在Startup.cs或者Program.cs中添加如下配置:
// .NET 5 Startup.cs 示例
services.Configure<ApiBehaviorOptions>(options =>
{
    options.SuppressInferBindingSourcesForParameters = true;
});

开启这个配置后,框架会回退到传统MVC的绑定逻辑,自动从查询字符串、路由、表单等位置匹配参数,不需要显式加[FromQuery]。不过该配置会全局修改API的绑定规则,可能导致后续接口的绑定行为不明确,不建议大范围使用。
2. 将GET接口的复杂类型参数拆分为多个基础类型参数,ApiController下的基础类型参数默认会从查询字符串/路由绑定,不需要额外加特性:

[HttpGet]
public IEnumerable<WeatherForecast> Get(int TemperatureC, string Summary)
{
    // 业务逻辑
}

内容的提问来源于stack exchange,提问作者Muhammad Hassan Javed

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.09.30 05:15:02