.NET Core 6调用第三方API偶发超时需重启IIS/应用池求助

根因判断 #

你描述的「故障触发后所有请求持续超时、同机Postman/curl请求正常、重启应用池立刻恢复、替换请求实现代码无效」特征，不属于第三方服务故障，也不属于HTTP客户端实现逻辑问题，本质是IIS工作进程（w3wp.exe）级别的TCP连接资源泄漏/临时端口耗尽、失效连接无法自动回收导致的。

同机其他工具请求正常的核心原因：Postman、curl属于独立进程，拥有独立的TCP端口配额与网络栈资源，和w3wp.exe进程的网络资源完全隔离；端口耗尽是进程级别的资源限制，和请求逻辑用托管还是非托管代码实现没有关系，所以替换请求代码无法解决问题。

排查步骤 #

故障发生时不要立刻重启应用池，按以下顺序定位：

• 登录QA环境服务器，执行命令netstat -ano | findstr "<第三方API目标IP> <第三方API端口>"，匹配w3wp.exe进程对应的PID，统计TCP连接状态：
  • 大量CLOSE_WAIT状态连接：存在连接/响应流未正确释放的问题，连接被泄漏无法归还连接池
  • 大量TIME_WAIT状态连接：短时间创建过多短连接，系统临时端口耗尽，新连接无法发起
  • 大量SYN_SENT状态连接：进程侧NAT/路由表项异常，TCP握手请求无法发出
• 检查对应IIS应用程序池配置，确认加载用户配置文件（Load User Profile）选项是否为False，该配置会导致.NET Core网络栈无法自动回收失效连接
• 用Wireshark抓w3wp.exe进程的出站包，过滤第三方API的目标IP，看故障发生时进程是否真的发出了TCP SYN握手包：如果没有SYN包发出，可100%确认是本机进程侧资源问题，和第三方服务无关
• 检查QA环境是否配置了强制出站代理，HttpClient默认的系统代理探测逻辑会缓存失效的代理实例，缓存直到进程重启才会刷新

修复方案 #

• 修正HttpClient的使用与配置，不要每次请求新建HttpClient实例，也不要直接用无配置的静态单例，通过IHttpClientFactory注册客户端并显式配置连接回收规则：

// Program.cs 服务注册代码
builder.Services.AddHttpClient("ThirdPartyUserApi", client =>
{
    client.Timeout = TimeSpan.FromSeconds(10);
})
.ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler
{
    PooledConnectionLifetime = TimeSpan.FromMinutes(5), // 定期回收长连接，规避失效连接、DNS缓存问题
    PooledConnectionIdleTimeout = TimeSpan.FromMinutes(2),
    MaxConnectionsPerServer = 50, // 限制单目标服务的最大并发连接数，避免瞬间打满端口
    UseCookies = false,
    UseProxy = false, // 无代理场景下显式关闭代理，跳过自动探测逻辑
    AutomaticDecompression = DecompressionMethods.All
});

• 所有请求逻辑必须显式释放响应对象与响应流，避免连接泄漏：

// 正确写法：用using包裹响应与流，保证连接及时归还连接池
using var response = await httpClient.GetAsync(requestUrl, HttpCompletionOption.ResponseHeadersRead);
response.EnsureSuccessStatusCode();
using var responseStream = await response.Content.ReadAsStreamAsync();
// 后续执行响应反序列化逻辑

• 调整服务器TCP/IP参数，加快端口回收、扩大可用端口范围，修改后重启服务器生效：
  1. 打开注册表编辑器，定位到路径HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters
  2. 新建DWORD值MaxUserPort，设置为十进制65534，扩大进程可用临时端口范围
  3. 新建DWORD值TcpTimedWaitDelay，设置为十进制30，将TIME_WAIT状态连接的默认等待时间从120秒缩短到30秒
• 调整IIS应用池配置：
  • 将对应应用池的加载用户配置文件选项设置为True
  • 配置应用池固定周期回收（比如每4小时回收一次），作为兜底自愈手段
  • 无特殊32位依赖的话，关闭启用32位应用程序选项
• 若QA环境必须走出站代理，显式给HttpClient配置固定代理地址，不要依赖默认的系统代理自动探测逻辑。

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