WinForms .NET应用调用API存图时连接失败及异常问题求助

从异常截图来看，属于无法建立TCP连接类错误，结合你已经尝试切换IP和localhost仍未解决的情况，按以下步骤逐一排查：

• 先验证API服务本身是否可用
  直接用浏览器、Postman或curl工具调用API的基础接口（比如健康检查接口），如果外部工具也访问失败，说明问题出在API服务端：

  • 确认API程序是否正常启动，有没有崩溃或未监听指定端口
  • 检查API的绑定地址，确保是0.0.0.0（允许所有IP访问）而非仅特定内网IP

• 检查本地网络与防火墙限制

  • 确认Windows Defender防火墙（或第三方防火墙）允许你的WinForms程序发起出站请求，在“允许应用通过防火墙”列表里找到你的程序并勾选对应的网络类型（私有/公网）
  • 如果API部署在远程服务器，检查服务器端防火墙/安全组是否开放了目标端口，且允许你的客户端IP访问

• 修正API地址配置细节

  • 核对代码中API地址的拼写：协议（HTTP/HTTPS）是否和API一致，端口号是否正确，有没有多余的斜杠或字符
  • 若使用localhost失败，尝试替换为127.0.0.1，同时确认API没有绑定到非回环IP

• 排除代理与证书问题

  • 系统代理配置错误可能导致连接失败，可在代码中临时禁用代理测试：

    var handler = new HttpClientHandler { UseProxy = false };
    using var client = new HttpClient(handler);
    

  • 如果API用HTTPS且是自签名证书，WinForms默认会拒绝，可临时添加证书信任（仅测试环境）：

    var handler = new HttpClientHandler
    {
        ServerCertificateCustomValidationCallback = (_, _, _, _) => true
    };
    using var client = new HttpClient(handler);
    

• 捕获完整异常信息
  在catch块中输出ex.ToString()，获取包含InnerException的完整错误栈，这能帮你定位具体是DNS解析失败、连接超时还是其他底层问题

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