生产环境无法连接远程API服务器，本地及Postman可正常访问

生产环境中应用调用远程API时抛出错误：System.Net.Http.HttpRequestException: Unable to connect to the remote server，但以下场景可正常运行：

• 相同API在本地环境工作完全正常
• 使用完全一致的请求信息，在Postman中调用该API也可成功

API端点：https://api.example.com/readmeter?key=YourAPIKey&cnt=10000&format=json&timezone=America~New_York&devices=DeviceID&start_date=22112024&end_date=25112024

已验证情况 #

• Postman和本地环境测试该API，均可正常工作
• 预期：该API在生产环境中同样正常运行
• 实际结果：抛出Unable to connect to the remote server错误

相关代码实现 #

public async Task<JsonResult> getAPIData(string fromDate, string toDate, string meter, string apiKey)
{
    var data = "";
    var logs = new List<string>();
    try
    {
        logs.Add("API call started.");

        // Security protocol configuration
        System.Net.ServicePointManager.SecurityProtocol =
            SecurityProtocolType.Tls12 |
            SecurityProtocolType.Tls11 |
            SecurityProtocolType.Tls;

        // Base URL from configuration
        var baseUrl = "https://api.example.com/";
        HttpClient client = new HttpClient { BaseAddress = new Uri(baseUrl) };
        client.Timeout = TimeSpan.FromMinutes(5);

        // Construct the final URL
        var apiUrl = $"readmeter?key={apiKey}&cnt=10000&format=json&timezone=America~New_York&devices={meter}&start_date={fromDate}&end_date={toDate}";
        logs.Add($"API URL: {client.BaseAddress}{apiUrl}");

        // Make the API call
        HttpResponseMessage response = await client.GetAsync(apiUrl);

        if (response.IsSuccessStatusCode)
        {
            logs.Add("API call successful.");
            string resultContent = await response.Content.ReadAsStringAsync();
            // Process response here...
        }
        else
        {
            logs.Add($"API failed. Status code: {response.StatusCode}");
        }
    }
    catch (Exception ex)
    {
        logs.Add($"Error: {ex.Message}");
        if (ex.InnerException != null)
        {
            logs.Add($"Inner Exception: {ex.InnerException.Message}");
        }
    }

    return Json(new { data, logs }, JsonRequestBehavior.AllowGet);
}

排查与解决方案 #

1. 生产环境网络限制 #

生产服务器大概率存在防火墙、代理或出站规则，阻断了对目标API的访问：

• 在生产服务器上执行ping api.example.com或Test-NetConnection api.example.com -Port 443（PowerShell），验证网络连通性
• 尝试用curl或Postman在生产服务器本地调用API，确认是否能正常响应
• 联系运维团队检查是否开放了443端口的出站权限，或是否需要配置代理

2. TLS协议兼容性 #

代码中虽指定了TLS版本，但生产环境的.NET运行时或系统可能存在兼容问题：

• 优先保留Tls12，因为TLS1.0/1.1已被多数服务淘汰，部分API服务器可能不再支持，修改代码：

System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;

• 确认生产环境的.NET版本是否支持TLS1.2（.NET Framework 4.5及以上支持，若为4.5以下需升级或打补丁）

3. HttpClient实例滥用 #

每次请求新建HttpClient会导致连接池耗尽、DNS缓存失效等问题：

• 改用单例模式复用HttpClient，示例如下：

// 全局单例，避免重复创建
private static readonly HttpClient _httpClient = new HttpClient();

static YourController()
{
    _httpClient.BaseAddress = new Uri("https://api.example.com/");
    _httpClient.Timeout = TimeSpan.FromMinutes(5);
    System.Net.ServicePointManager.SecurityProtocol = SecurityProtocolType.Tls12;
}

public async Task<JsonResult> getAPIData(string fromDate, string toDate, string meter, string apiKey)
{
    var data = "";
    var logs = new List<string>();
    try
    {
        logs.Add("API call started.");

        var apiUrl = $"readmeter?key={Uri.EscapeDataString(apiKey)}&cnt=10000&format=json&timezone={Uri.EscapeDataString("America~New_York")}&devices={Uri.EscapeDataString(meter)}&start_date={Uri.EscapeDataString(fromDate)}&end_date={Uri.EscapeDataString(toDate)}";
        logs.Add($"API URL: {_httpClient.BaseAddress}{apiUrl}");

        HttpResponseMessage response = await _httpClient.GetAsync(apiUrl);

        if (response.IsSuccessStatusCode)
        {
            logs.Add("API call successful.");
            string resultContent = await response.Content.ReadAsStringAsync();
            // Process response here...
        }
        else
        {
            logs.Add($"API failed. Status code: {response.StatusCode}");
        }
    }
    catch (Exception ex)
    {
        logs.Add($"Error: {ex.Message}");
        if (ex.InnerException != null)
        {
            logs.Add($"Inner Exception: {ex.InnerException.Message}");
        }
    }

    return Json(new { data, logs }, JsonRequestBehavior.AllowGet);
}

4. 参数URL编码问题 #

直接拼接参数可能因特殊字符导致请求无效：

• 对所有参数使用Uri.EscapeDataString进行编码，避免URL格式错误，如上述示例中的参数处理

5. DNS解析异常 #

生产环境DNS服务器可能无法正确解析API域名：

• 在生产服务器执行nslookup api.example.com，确认解析出的IP地址是否正确
• 若解析异常，可临时在代码中使用API服务器的IP地址测试（仅用于排查，不建议长期使用）

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