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的默认绑定逻辑,可以选择以下方式:
- 关闭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
相关产品推荐
相关产品推荐

