C#使用HttpClient向跨项目REST API POST JSON数据失败求助

核心问题：JSON结构与服务端接收模型不匹配 #

你客户端序列化生成的JSON外层多了一层agent节点，实际生成的JSON结构如下：

{
  "agent": {
    "Id": 3,
    "Text": "Test item3"
  }
}

但服务端[FromBody]绑定的CustomListItem是直接接收Id和Text属性的根对象，没有外层的agent包装，导致服务端反序列化后model为null，直接触发BadRequest返回，请求自然不会生效。

修复方法： #

调整客户端序列化逻辑，去掉外层的agent包装：

string payload = JsonConvert.SerializeObject(new
{
    Id = 3,
    Text = "Test item3",
});

其他可能导致请求失效的问题 #

• 异步方法使用async void导致请求未完成就被终止
  DoIt方法用了async void，这类异步方法无法被等待，一旦调用方执行完毕退出，可能PostAsync还没完成请求就被销毁。需要将方法返回值改为Task，调用处添加await关键字：

  private static async Task DoIt()
  {
      // 原有逻辑
  }
  

• 未处理请求响应，无法定位具体错误
  当前客户端拿到HttpResponseMessage后没有做任何校验，建议加日志/断点查看响应状态码、响应内容，快速定位问题：

  // PostAsync后添加
  Console.WriteLine($"响应状态码：{(int)response.StatusCode}");
  string respContent = await response.Content.ReadAsStringAsync();
  Console.WriteLine($"响应内容：{respContent}");
  

• HttpClient重复实例化问题
  每次请求都new HttpClient会导致套接字资源耗尽，建议将HttpClient改为全局静态单例：

  private static readonly HttpClient _client = new HttpClient();
  private static async Task DoIt()
  {
      // 后续直接用_client发请求，不用每次new
  }
  

• 路由匹配校验
  确认服务端接口的路由配置与请求地址https://localhost:44323/api/listid一致，比如控制器是否命名为ListidController，有没有配置额外的路由前缀等。

内容的提问来源于stack exchange，提问作者Shay Avitapl