.NET 8 API通过HttpClient调用.NET Framework 4遗留接口返回404排查求助

1. 核对请求URL的准确性 #

• 检查代码中url变量与直接调用时的地址是否完全一致，包括协议（http/https）、域名、端口、路径，注意大小写差异（部分路由配置可能对大小写敏感）
• 直接复制代码中的url到Postman、curl等工具测试，确认是否能正常响应，排除URL拼写错误

2. 验证请求内容的格式兼容性 #

• .PostAsJsonAsync默认使用System.Text.Json序列化，而.NET Framework 4 Web API默认依赖Newtonsoft.Json，两者序列化行为存在差异：
  • 检查属性名称大小写（System.Text.Json默认小驼峰，Newtonsoft.Json默认大驼峰）
  • 检查特殊类型（如DateTime、Nullable）的序列化格式，避免因格式不兼容导致路由匹配失败
• 尝试手动用Newtonsoft.Json序列化并发送请求，测试是否恢复正常：

  var json = JsonConvert.SerializeObject(request);
  var content = new StringContent(json, Encoding.UTF8, "application/json");
  var responseMessage = await httpClient.PostAsync(url, content);
  

3. 检查HttpClient的默认配置差异 #

• 检查HttpClient是否自动添加了敏感请求头（如Accept-Encoding、User-Agent），部分老旧IIS或遗留API可能对这类头有限制
• 模拟直接调用时的请求头（可通过Fiddler抓取直接调用的头信息，在代码中手动设置）：

  httpClient.DefaultRequestHeaders.Clear();
  httpClient.DefaultRequestHeaders.Add("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64)");
  // 补充其他直接调用时的必要请求头
  

• 关闭自动重定向功能，避免遗留API的重定向配置导致404：

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

4. 排查遗留API的路由和IIS配置 #

• 检查遗留API的路由规则，确认是否存在基于请求内容、请求头的路由约束，比如仅接受特定Content-Type的请求
• 查看IIS 8.5的配置：
  • 检查请求筛选规则是否拦截了.NET 8发出的请求（如限制请求大小、特定请求头）
  • 查看IIS日志（默认路径C:\inetpub\logs\LogFiles），根据404子状态码（如404.13请求过大、404.7请求筛选拦截）定位问题
  • 确认应用程序池是否启用32位模式，排查与64位.NET 8的兼容性问题

5. 对比直接调用与代码调用的请求差异 #

• 用Fiddler或Wireshark捕获两种请求的数据包，对比以下内容：
  • 请求行的URL、方法是否完全一致
  • 请求头的所有字段（Content-Type、Content-Length等）
  • 请求体的序列化内容、编码格式
• 重点排查是否存在编码差异、换行符差异，或代码调用时遗漏了必要请求头

6. 检查网络与环境隔离问题 #

• 确认.NET 8服务器能访问遗留API服务器，用ping、telnet测试连通性
• 排查防火墙、代理服务器是否拦截了请求或响应
• 若.NET 8部署在容器中，检查容器网络配置是否允许访问内网或宿主机的遗留API

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