ASP.NET Web API：如何将AMP XHR POST请求体直接映射到C#控制器输入？

嗨，我来帮你搞定这个参数为null的问题！你遇到的情况大概率是请求格式、模型绑定配置或者控制器标注没弄对，咱们一步步来排查：

Web API默认不会自动把复杂类型从请求体里绑定，得明确告诉它来源：

• 给你的lead参数加上[FromBody]特性，示例代码：

  public IHttpActionResult SaveLead([FromBody] Lead lead)
  {
      // 你的业务逻辑
  }
  

• 如果是multipart/form-data的表单请求，单纯的[FromBody]可能不够，这时候可以结合[ModelBinder]，或者确保模型属性和表单字段名完全匹配（包括大小写，虽然默认不区分，但严格对应更稳妥）。

模型绑定的前提是模型本身符合要求：

• 模型必须有无参构造函数，Web API需要它来实例化对象；
• 模型的属性名称要和请求里的表单字段/JSON键完全一致，比如请求传"Email"，模型里就得有public string Email { get; set; }；
• 如果有嵌套对象（比如Lead里包含Address类），请求里的字段要对应嵌套结构，比如"Address.Street"。

你之前给JsonFormatter添加multipart/form-data支持的做法可能不对——JsonFormatter是处理JSON格式的，而multipart/form-data是边界分隔的表单/多部分数据，两者逻辑不一样：

• 如果你的请求是普通表单键值对：不需要修改JsonFormatter，确保Web API默认的MultipartFormDataMediaTypeFormatter启用即可，代码如下：

  // 确保multipart格式化器存在
  if (!config.Formatters.Any(f => f is MultipartFormDataMediaTypeFormatter))
  {
      config.Formatters.Add(new MultipartFormDataMediaTypeFormatter());
  }
  

• 如果你的请求是multipart里包含JSON部分：要在请求里给对应part设置Content-Type: application/json，而不是让JsonFormatter处理整个multipart请求。比如用Postman时，添加一个form-data项，选择raw格式，选JSON，粘贴你的Lead JSON内容，然后手动设置这个项的Content-Type为application/json。

在控制器方法里先读取原始请求内容，看看实际传过来的是什么：

public async Task<IHttpActionResult> SaveLead([FromBody] Lead lead)
{
    // 读取原始请求内容
    var rawContent = await Request.Content.ReadAsStringAsync();
    // 把rawContent输出到日志或者调试窗口，检查是否和预期一致
    // 比如是否字段名写错了，或者JSON格式有语法错误

    // 后续逻辑
}

通过原始内容能快速判断是请求格式错误，还是模型绑定的问题。

建议用Postman或者Swagger来测试，避免手动构造请求时出错：

• 如果是表单请求：选择form-data选项，逐个添加字段，字段名严格匹配模型属性；
• 如果是JSON请求：选择raw格式，选JSON，粘贴正确的Lead JSON字符串，并且设置请求头Content-Type: application/json（如果是multipart里的JSON，单独给对应part设置Content-Type）。

内容的提问来源于stack exchange，提问作者Sahil Sharma