C#调用API本地运行正常部署后报System.Net.WebException连接超时如何解决

问题根因定位 #

这个错误属于部署环境到目标API服务器的网络连通性故障，本地调试正常说明代码逻辑本身没有问题，问题出在部署服务器的网络策略层面。

排查步骤 #

• 先在部署服务器上直接测试网络连通性：
  1. 打开部署服务器的浏览器，直接访问API地址https://qms.futuregenerali.in/FGClaimWsAPI/api/Common/FetchClaimdetails，看是否能正常打开（如果是POST接口可以用Postman等工具模拟请求）
  2. 用telnet或者PowerShell命令测试443端口连通性：Test-NetConnection qms.futuregenerali.in -Port 443，如果返回TcpTestSucceeded为False就是端口不通
• 检查部署服务器的出站防火墙规则：确认是否有禁止访问外部443端口、或者禁止访问目标域名的策略
• 检查是否需要配置代理：很多企业内部服务器访问外部公网接口需要配置HTTP/HTTPS代理，本地调试时你自己的电脑已经配置了代理所以能通，服务器没配置就会超时
• 检查目标API的IP白名单策略：部分外部接口会限制调用方IP，只允许你本地的公网IP访问，没加部署服务器的公网IP就会被拦截

代码优化建议 #

现有代码可以做三处调整提升稳定性：

1. 手动配置代理适配部署环境，给HttpWebRequest加上代理配置项：

// 如果需要代理的话开启，参数替换为你们公司的代理地址和端口
// httpWebRequest.Proxy = new WebProxy("http://your-proxy-address:port", true);
// 不需要代理的话显式设置为null避免读取系统默认代理导致的异常
httpWebRequest.Proxy = null;

2. 不要硬拼接JSON字符串，避免特殊字符转义问题，改用Newtonsoft.Json或者System.Text.Json序列化：

// System.Text.Json序列化示例
string json = JsonSerializer.Serialize(new { ClaimNo = userProfile.ClaimNumber });

3. 不要把Timeout设为-1（无限超时），建议设置合理的超时时间比如30000（30秒），避免请求无限挂起占用服务器资源

System.Net.WebException: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.
以上报错90%以上的概率都是前面提到的网络连通性问题，按排查步骤逐一验证即可定位到具体原因。

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