C# Web API客户端调用超时（ERR_CONNECTION_TIMED_OUT）求助

看起来你遇到了跨机器调用Web API的连接超时问题，本地在Visual Studio和IIS运行正常，说明API本身的业务逻辑没问题，问题大概率出在网络连通性或者服务器对外的配置环节上。我给你梳理几个关键排查方向，按顺序试下来应该能定位到问题：

1. 优先检查端口的对外开放权限 #

你用的是8081端口，这是第一个要排查的点：

• 先检查服务器的Windows Defender防火墙（或第三方防火墙）：有没有添加入站规则，允许TCP 8081端口的外部请求。可以临时关闭防火墙做测试，如果关闭后能正常调用，就去防火墙里添加一条允许8081端口入站的规则。
• 如果是云服务器部署，还要检查云服务商的安全组：比如阿里云、腾讯云的安全组必须添加入站规则，开放8081端口的TCP访问，否则外部请求根本无法到达服务器。

2. 验证客户端到服务器的网络连通性 #

用几个简单命令确认网络层面是否通畅：

• 在客户端机器上执行 ping xxx.xxx.com，看能不能解析到正确的服务器IP，且网络延迟正常。如果ping不通，说明DNS解析有问题，或者服务器的公网/局域网IP配置错误。
• 如果ping通了，再用 telnet xxx.xxx.com 8081 测试端口连通性。如果telnet连接失败，那肯定是端口没开放，回到第一步排查防火墙和安全组。
• 也可以用PowerShell命令 Test-NetConnection xxx.xxx.com -Port 8081，这个命令会直接返回端口是否可连通，以及具体的失败原因，比telnet更直观。

3. 检查IIS的站点绑定配置 #

本地IIS运行正常，但外部访问不了，要确认IIS的绑定是否正确：

• 打开IIS管理器，找到你的API站点，查看绑定信息：IP地址不要只绑定127.0.0.1，要绑定*（所有IP）或者服务器的公网/局域网IP；端口确认是8081；主机头如果不需要就留空，避免限制了特定域名的访问。
• 确认应用程序池状态是启动的，且.NET版本和你的API兼容：比如你的API是.NET 6，应用程序池要选择“无托管代码”或者对应的.NET版本。

4. 排查CORS配置的细节 #

你已经启用了CORS，但还要确认配置是否覆盖了你的客户端请求：

• 测试阶段可以临时把CORS配置改成允许所有来源、方法和头部：builder.Services.AddCors(options => options.AddPolicy("AllowAll", policy => policy.AllowAnyOrigin().AllowAnyMethod().AllowAnyHeader()));，然后在中间件里启用这个策略。如果这样能解决，说明之前的CORS配置有严格限制，和客户端请求不匹配。
• 打开客户端浏览器的开发者工具→Network标签，查看请求的详细信息：有时候浏览器显示超时，但实际是CORS预检请求失败，只是提示不明确，这里能看到具体的状态码和错误信息。

5. 检查服务器上的端口占用情况 #

有时候8081端口可能被其他程序占用，导致IIS虽然显示绑定成功，但实际没监听这个端口：

• 在服务器上打开命令提示符，执行 netstat -ano | findstr :8081，查看哪个进程占用了8081端口。如果不是你的API对应的进程，就杀掉该进程，然后重启IIS站点。

6. 确认客户端的请求URL是否正确 #

最后再核对一遍客户端的请求路径：

• 比如你的API控制器用了[Route("api/[controller]")]路由，那客户端的请求URL应该是 http://xxx.xxx.com:8081/api/YourControllerName，有没有少写api前缀，或者控制器名称拼写错误？
• 本地测试用的是localhost:8081/...，换成域名后有没有路径上的差异？

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