同服务器部署的WEB API跨项目调用返回404错误排查

问题定位依据 #

从返回的响应头Server: Microsoft-HTTPAPI/2.0可以直接判断：请求没有进入目标WEB API的应用处理管道，是Windows内核层HTTP.SYS组件直接返回的404响应——即HTTP.SYS收到请求后，没有匹配到任何已注册的站点/服务URL前缀，直接返回默认错误页，和应用内的路由规则、接口逻辑没有关系。

Postman调用正常但同服务器代码调用异常，按以下优先级排查即可解决：

• 排查1：域名解析/访问目标不匹配
  先在调用代码中加日志，输出aws-av-devser在当前代码运行上下文（比如IIS应用池、系统服务上下文）解析到的IP地址，和Postman运行环境的解析结果做对比。最常见的场景是：Postman在个人开发机运行，解析到服务器正确的内网IP；但代码在服务器本地运行时，域名被解析到公网IP/IPv6环回地址/其他网卡IP，请求打到了服务器80端口上的其他服务，自然返回404。
  临时把调用URI替换为http://127.0.0.1/Assigning_ID/api/QidMasters/2测试，如果调用成功即可确认是域名解析问题。
  如果你的API是Kestrel/HttpListener自托管（不经过IIS），需要确认服务注册的URL前缀覆盖了请求使用的域名，不要只绑定localhost。
• 排查2：Host头被异常覆盖
  检查HttpClient初始化代码，确认没有手动给DefaultRequestHeaders覆盖过Host请求头。如果Host值和IIS/自托管服务中绑定的域名不匹配，请求会落到80端口的默认站点上，默认站点没有对应接口路径就会返回404。
  可以同时开启IIS日志，对比Postman请求和代码请求记录的主机名、请求路径差异，快速定位问题。
• 排查3：代理配置干扰请求路由
  检查调用方项目的运行环境有没有配置系统代理，或者HttpClient是否启用了默认代理，导致请求被转发到其他非目标服务器。可以在初始化HttpClient时显式禁用代理测试：

  var httpClient = new HttpClient(new HttpClientHandler
  {
      UseProxy = false
  });
  

• 排查4：URL路径被意外拼接错误
  检查HttpClient是否配置了BaseAddress，如果BaseAddress末尾缺少斜杠、和传入的URI拼接逻辑错误，会导致实际请求路径和预期不符。即使传入的是绝对URI，部分.NET版本下错误的BaseAddress配置也会导致路径异常。可以在发起请求前加日志，确认实际请求的URI和Postman调用的完全一致，没有多余斜杠、字符转义、缺漏字符的问题。

快速定位技巧 #

HTTP.SYS返回的315字节文本内容里包含具体的错误子状态和原因描述，你可以在代码里把错误内容读出来打印，不用盲猜：

var uri = "http://aws-av-devser/Assigning_ID/api/QidMasters/2";
var response = await httpClient.GetAsync(uri);
// 输出以下内容即可看到具体的404原因
var errorDetail = await response.Content.ReadAsStringAsync();

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