.net core Web API参数绑定规则

参数推理绑定

先从一个问题说起，微信小程序按照WebAPI定义的参数传递，Get请求服务器端可以正常接收到参数，但是Post请求取不到。
Web API代码（.netcore 3.1）如下：

[HttpGet("Login")]
public LoginResult Login(string code)
{
  ...
}
[HttpPost("PostAvatar")]
public BaseResult<string> PostAvatar(int id,string imgUrl)
{
...
}

客户端代码（微信小程序js）如下：

    wx.request({
      url: '/api/Login',
      data:{code:'xxx'},
      method:'GET',
      success:function(res){}
    })
    wx.request({
      url: '/api/PostAvatar',
      data: { id: 1,imgUrl:'xxx' },
      method: 'POST',
      success: function (res) { }
    })

后来发现如果把参数放在一个实体里就可以接收到，像这样

[HttpPost("PostAvatar")]
public BaseResult<string> PostAvatar(Avatar model)
{
...
}
...
public class Avatar
{
   public int Id { get; set; }
   public string imgUrl{ get; set; }
}

于是找到官方文档对于绑定源参数推理的解释：

Web API 还有一套默认的推理规则，意思就是上面的这些特性可以加在参数的前面用来强制的指定这个参数是用那种方式获取，但是如果不显式的声明，它会按照这套规则默认匹配。规则如下：

默认按照从上到下的顺序去匹配，最后才是FromQuery，所以最开始的问题就解释通了，因为简单类型的参数如果不显式指定类型就是从Query里取，而我们的用的post请求方式，参数都在body里所以服务器接收不到。

简单类型、复杂类型混合

知道了上面的推理规则，所以下面的这个例子里，wechat参数因为是简单类型所以不会跟其他的参数在一起，必须放在URL里。

[HttpPost("PostAvatar")]
public BaseResult<string> PostAvatar(Avatar model,int wechat)
{
...
}
...
public class Avatar
{
   public int id { get; set; }
   public string imgUrl{ get; set; }
}

js的请求必须是这样才行

    wx.request({
      url: '/api/PostAvatar?wechat=1',//增加在这
      data:{
        id:1,
        imgUrl:'',
        //wechat:1 放在data里一样取不到
      },
      method:"POST",
      success:function(res){
      ...
      }
    })

空key问题

问题还没完，如果想把所有POST请求使用统一的格式，单个参数也想放在body里请求，是不是按照上面的绑定规则显式指定为FromBody就可以呢？

public IActionResult Post([FromBody] string name) { ... }

答案是：依然取不到，因为js发送的body是这样的

{"name":"xxxx"}

而webapi期望的body里只有xxxx。

总结

Web API 参数的绑定如果不是显式的指定会按照一定默认规则识别参数的来源，GET请求比较简单从QueryString中取值，POST请求会因为参数的类型有所不同。

[FromBody]和[FromForm]还是有些差别的，涉及到了ContentType后续可能还会针对HTTP请求的一些细节做些说明。

文章中有错误的还请留言交流！！！

参考文章：

使用 ASP.NET Core 创建 Web API
ASP.NET WebAPI 中的参数绑定

古道