使用HttpClient调用Web API 2接口时出现404错误求助

结合你的代码和现象来看，问题大概率出在参数绑定规则与路由匹配的配合上，下面给你几个具体的排查方向和解决方案：

1. 简单类型参数的默认绑定规则坑点 #

Web API 2对POST请求的简单类型参数（比如Guid?这类），默认会优先从URI的路由或查询字符串中取值，而非请求体。你现在把uid放在Form表单的请求体里，但接口参数没指定绑定来源，导致框架找不到参数值，进而无法匹配到对应的动作方法，最终返回404。

解决办法： #

• 方法一：将参数放到查询字符串中
  修改调用时的path为：

  string path = $"localhost:12345/api/contact/getsomething?uid={someGuid.ToString()}";
  

  接口代码保持不变即可，框架会自动从查询字符串读取uid参数，路由也能正常匹配。

• 方法二：指定参数从请求体绑定
  如果一定要从Form表单传参，需要给接口参数加上[FromBody]属性，但要注意Web API 2对[FromBody]处理application/x-www-form-urlencoded内容的特殊规则：它只会读取第一个键值对的值，忽略键名。所以调用代码要改成：

  var obj = new List<KeyValuePair<string, string>>
  {
      new KeyValuePair<string, string>("", someGuid.ToString()) // 键名留空
  };
  var response = client.PostAsync(path, new FormUrlEncodedContent(obj)).Result;
  

  接口代码调整为：

  [HttpPost]
  public MyModel GetSomething([FromBody] System.Nullable<System.Guid> uid)
  {
      return GetMyModel(uid);
  }
  

2. 使用DTO类接收参数（更推荐的规范写法） #

对于POST请求，更稳妥的方式是用DTO（数据传输对象）封装参数，既可以避免绑定规则的坑，也方便后续扩展参数。

步骤： #

1. 定义DTO类：

public class GetSomethingRequest
{
    public Guid? Uid { get; set; }
}

2. 修改接口：

[HttpPost]
public MyModel GetSomething([FromBody] GetSomethingRequest request)
{
    return GetMyModel(request.Uid);
}

3. 调用代码保持你原来的写法即可：

var obj = new List<KeyValuePair<string, string>>
{
    new KeyValuePair<string, string>("uid", someGuid.ToString())
};
var response = client.PostAsync(path, new FormUrlEncodedContent(obj)).Result;

这种方式下，框架能正确解析Form表单中的uid字段并绑定到DTO属性上，路由匹配也不会出问题。

3. 路由模板的匹配验证 #

你的默认路由模板是api/{controller}/{action}/{id}，其中id是可选参数，但接口参数是uid，框架不会自动把uid映射到id参数上。不过因为你的参数不是路由参数（是查询字符串或请求体参数），这本身不会导致404，但可以确认两点：

• 请求路径中的controller是contact（对应ContactController，Web API路由不区分大小写），action是getsomething（对应GetSomething方法，同样不区分大小写），这部分你已经做对了。
• 如果想把uid作为路由参数，可以修改路由模板为api/{controller}/{action}/{uid}，但这样会影响其他接口的路由，非必要不推荐。

4. 其他快速排查点 #

• 用Fiddler或Postman直接测试接口：发送POST请求到localhost:12345/api/contact/getsomething，在查询字符串加uid=xxx，看是否能正常返回，快速定位是接口问题还是调用端问题。
• 检查Web API配置中是否启用了属性路由（比如有没有config.MapHttpAttributeRoutes();），如果其他接口用了属性路由而这个接口没加，可能引发路由冲突，但你的其他接口正常，这个可能性较低。

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