ASP.NET Core Web API POST请求返回HTTP 400错误求助

1. 客户端请求Content-Type缺失 #

你的客户端代码创建StringContent时未指定媒体类型，默认是text/plain，但ASP.NET Core Web API的[FromBody]绑定默认仅接受application/json类型请求，这会直接导致模型绑定失败触发400错误。

修改客户端代码：

var Payload_Content = new StringContent(
    JsonSerializer.Serialize(Payload),
    Encoding.UTF8,
    "application/json" // 明确指定Content-Type为JSON格式
);

2. 控制器端点参数绑定错误 #

ASP.NET Core无法直接从POST的JSON体中绑定多个独立参数，必须通过模型类配合[FromBody]特性实现绑定：

• 先定义请求模型类：

  public class SetPcRequest
  {
      public string Param1 { get; set; }
      public decimal Param2 { get; set; }
      public string Param3 { get; set; }
      public string Param4 { get; set; }
      public string? Param5 { get; set; }
      public string? Param6 { get; set; }
      public string? Param7 { get; set; }
      public string? Param8 { get; set; }
  }
  

• 调整控制器方法：

  [HttpPost("SetPc")]
  public IActionResult SetPc([FromBody] SetPcRequest request)
  {
      if (!ModelState.IsValid)
      {
          // 返回模型验证错误详情，方便排查
          return BadRequest(ModelState);
      }
      bool result = _yourService.Set_PC(request.Param1, request.Param2, request.Param3, request.Param4, request.Param5, request.Param6, request.Param7, request.Param8);
      return Ok(result);
  }
  

3. 模型验证失败 #

检查请求参数是否符合API或数据库的约束：

• 确认param1/param3/param4是否满足非空、长度限制等要求
• 检查param2的decimal精度是否匹配存储过程参数定义，比如存储过程@PARAM2是否为DECIMAL(10,3)或更高精度，避免因精度溢出触发验证错误
• 客户端可捕获BadRequest的详细错误信息：

  else if (Response.StatusCode == HttpStatusCode.BadRequest)
  {
      string errorContent = await Response.Content.ReadAsStringAsync();
      Debug.WriteLine("Bad Request 详情: " + errorContent);
  }
  

4. 路由匹配问题 #

确认客户端请求Urihttp://somepath/somepath/somepath/SetPc与控制器路由完全匹配：

• 检查控制器的[Route]特性，比如控制器是否配置了[Route("api/[controller]")]，需保证完整路由路径一致
• 确认[HttpPost("SetPc")]的路由模板无大小写或路径层级错误

5. JSON序列化/反序列化问题 #

• 输出JsonSerializer.Serialize(Payload)的结果，确认null参数（如param7、param8）被正确序列化为null而非被忽略
• 检查客户端JsonSerializerOptions是否配置了正确的nullable类型处理规则

6. 查看服务端详细日志 #

在ASP.NET Core项目的appsettings.json中开启调试级日志，查看绑定错误的具体原因：

{
    "Logging": {
        "LogLevel": {
            "Microsoft.AspNetCore": "Debug",
            "Microsoft.AspNetCore.Mvc.ModelBinding": "Debug"
        }
    }
}

运行项目后，通过控制台或日志文件获取模型绑定的详细错误信息，这是定位问题最直接的方式。

内容的提问来源于stack exchange，提问作者taqasar-elcam