如何用System.Net.Http.HttpClient替代WebRequest？服务器部署遇500错误

当前500错误的根因与临时修复 #

报错System.UriFormatException: Invalid URI: The format of the URI could not be determined.是因为传入的URL不符合标准URI格式，最常见的场景是URL缺少http://或https://前缀。本地测试正常可能是因为你输入的URL都带了前缀，但部署到服务器后，用户输入的URL未添加前缀，导致解析失败。

临时修复可在创建请求前补全前缀：

public static bool WebRequestTest(string url)
{
    try
    {
        // 补全URL前缀
        if (!url.StartsWith("http://", StringComparison.OrdinalIgnoreCase) && !url.StartsWith("https://", StringComparison.OrdinalIgnoreCase))
        {
            url = "https://" + url;
        }
        
        System.Net.WebRequest myRequest = System.Net.WebRequest.Create(url);
        System.Net.WebResponse myResponse = myRequest.GetResponse();
    }
    catch (System.Net.WebException)
    {
        return false;
    }
    catch (System.UriFormatException)
    {
        return false;
    }
    return true;
}

替换WebRequest为HttpClient的最优方案 #

微软已明确不推荐在新开发中使用WebRequest及其派生类，HttpClient是更高效、易用的替代方案，且支持异步操作。注意HttpClient需全局单例使用，避免频繁创建导致资源泄漏。

步骤1：创建全局单例HttpClient #

在项目的全局类（如Global.asax或Startup类）中初始化静态HttpClient实例：

private static readonly HttpClient _httpClient = new HttpClient();

步骤2：改造检测方法为异步实现 #

替换原WebRequestTest方法为异步版本，同时处理URL前缀问题：

public static async Task<bool> CheckSiteAvailability(string url)
{
    // 补全URL前缀，避免格式错误
    if (!url.StartsWith("http://", StringComparison.OrdinalIgnoreCase) && !url.StartsWith("https://", StringComparison.OrdinalIgnoreCase))
    {
        url = "https://" + url;
    }

    try
    {
        // 使用HEAD请求更轻量，仅验证站点可达性，无需下载响应内容
        var response = await _httpClient.SendAsync(new HttpRequestMessage(HttpMethod.Head, url));
        return response.IsSuccessStatusCode;
    }
    catch (HttpRequestException)
    {
        // 捕获请求异常（如网络不通、站点不可达）
        return false;
    }
    catch (UriFormatException)
    {
        // 捕获URL格式错误
        return false;
    }
}

步骤3：调整调用逻辑 #

由于改造为异步方法，调用处需同步适配异步逻辑，例如在MVC Controller中：

public async Task<IActionResult> CheckSite(string url)
{
    bool isAvailable = await CheckSiteAvailability(url);
    return Json(new { IsAvailable = isAvailable });
}

关键优势说明 #

• 异步性能：async/await避免阻塞线程，提升服务器并发处理能力
• 资源高效：全局单例HttpClient复用连接池，避免Socket资源耗尽
• 轻量请求：HEAD请求仅获取响应头，比GET请求更节省带宽和时间

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