You need to enable JavaScript to run this app. ASP.NET/C#中无法向ASP.NET Core 5.0 WebAPI POST接口传递NameValueCollection
优惠活动
大模型
产品
解决方案
定价
更多

ASP.NET/C#中无法向ASP.NET Core 5.0 WebAPI POST接口传递NameValueCollection

问题解答

错误原因

你碰到415报错的核心原因是 ASP.NET Core 中 [FromBody] 特性默认不支持绑定 application/x-www-form-urlencoded 类型的请求体到 NameValueCollection 或自定义包裹类:

  • [FromBody] 设计用来处理JSON、XML等序列化的请求体,需要对应媒体类型的输入格式化器才能完成绑定,而ASP.NET Core内置没有提供form-urlencoded格式到NameValueCollection的格式化器,框架找不到可以处理当前请求的格式化器,就会直接返回415状态码。
  • application/x-www-form-urlencoded 类型的表单数据,需要用[FromForm]特性来绑定,而不是[FromBody]。

可行解决方案

以下三种方案都不需要修改现有客户端代码,直接调整控制器代码即可正常运行:

方案1:用[FromForm]绑定IFormCollection(推荐)

IFormCollection本身就是键值对结构,用法和NameValueCollection几乎一致,直接索引就能取值:

namespace Webservice.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WebserviceController : ControllerBase
    {
        [HttpPost]
        [Consumes("application/x-www-form-urlencoded")]
        public string Post([FromForm] IFormCollection values)
        {
            // 示例取值:values["key1"] 即可拿到 "value1"
            return "values received";
        }
    }
}

方案2:直接读取Request.Form获取NameValueCollection

如果你一定要使用NameValueCollection类型,可以直接从请求对象中读取,不需要做参数绑定:

namespace Webservice.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WebserviceController : ControllerBase
    {
        [HttpPost]
        [Consumes("application/x-www-form-urlencoded")]
        public string Post()
        {
            NameValueCollection values = Request.Form;
            // 直接使用values即可
            return "values received";
        }
    }
}

ASP.NET Core 中Request.Form支持隐式转换为NameValueCollection,不需要额外做转换处理。

方案3:自定义模型绑定表单字段

如果你需要按字段强类型绑定,可以定义对应属性的接收类,用[FromForm]绑定:

public class FormReceiveModel
{
    public string Key1 { get; set; }
    public string Key2 { get; set; }
}

namespace Webservice.Controllers
{
    [ApiController]
    [Route("[controller]")]
    public class WebserviceController : ControllerBase
    {
        [HttpPost]
        [Consumes("application/x-www-form-urlencoded")]
        public string Post([FromForm] FormReceiveModel model)
        {
            // 直接通过model.Key1、model.Key2取值
            return "values received";
        }
    }
}

内容的提问来源于stack exchange,提问作者Computer User

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.14 19:27:03