C#教程

关注公众号 jb51net

关闭
首页 > 软件编程 > C#教程 > C#实现HTTP请求通讯

C#中实现HTTP请求通讯的操作指南

作者：加号3

在现代软件开发中,HTTP 协议是应用程序与外部服务交互的核心桥梁,C# 作为 .NET 生态的主力语言,提供了丰富而成熟的 HTTP 通讯能力,本文将系统介绍 C# 中实现 HTTP 请求的技术选型、核心概念、常见场景及最佳实践,需要的朋友可以参考下

引言

在现代软件开发中，HTTP 协议是应用程序与外部服务交互的核心桥梁。C# 作为 .NET 生态的主力语言，提供了丰富而成熟的 HTTP 通讯能力。本文将系统介绍 C# 中实现 HTTP 请求的技术选型、核心概念、常见场景及最佳实践，帮助开发者构建稳定、高效的网络通讯模块。

一、技术选型：HttpClient 与 HttpWebRequest

C# 中进行 HTTP 请求主要有两种方式，理解它们的差异是正确选型的前提。

1.1 HttpClient（推荐）

HttpClient 是 .NET Framework 4.5 及 .NET Core/.NET 5+ 中官方推荐的 HTTP 客户端。它基于异步任务模型设计，支持连接池复用、请求管道定制和取消令牌等现代特性。其最大优势在于连接复用——多个请求可以共享同一个底层 TCP 连接，显著减少资源消耗和延迟。
HttpClient 实例设计为可长期复用，不应为每个请求创建新实例。最佳实践是在应用程序生命周期内保持单例或有限数量的实例，通过依赖注入统一管理。

1.2 HttpWebRequest（遗留）

HttpWebRequest 是 .NET 早期版本的 HTTP 客户端实现，基于同步编程模型。虽然功能完整，但存在连接无法复用、资源释放不及时等问题。微软已将其标记为遗留 API，新项目应优先选择 HttpClient。

二、请求构建的核心要素

一个完整的 HTTP 请求包含多个可配置维度，掌握这些要素是灵活实现通讯的基础。

2.1 HTTP 方法

HTTP 协议定义了多种请求方法，每种方法对应不同的语义：

2.2 请求头（Headers）

请求头携带了关于请求的元信息，常见的包括：

2.3 请求体（Body）

POST、PUT、PATCH 等请求通常需要携带请求体。C# 中可将多种数据类型序列化为请求体：

2.4 URL 与查询参数

请求地址由协议、主机、路径和查询参数组成。查询参数需要进行 URL 编码，确保特殊字符（如空格、中文、符号）不会破坏 URL 结构。现代 C# 提供了 URI 构建器，可安全地拼接路径和参数。

三、响应处理的关键环节

发送请求后，正确处理响应同样重要。

3.1 状态码解析

HTTP 响应状态码分为五类，C# 程序应根据状态码采取不同的处理逻辑：

3.2 响应内容读取

响应内容通常以字符串或流的形式返回。对于 JSON 格式的响应，可以反序列化为强类型对象，便于后续业务处理。对于大文件下载场景，建议使用流式读取，避免一次性加载到内存导致性能问题。

3.3 响应头处理

响应头中可能包含重要的元信息，如内容类型、内容长度、缓存策略、请求追踪 ID 等。某些 API 会将分页信息（如总记录数、下一页链接）放在响应头中，需要特别解析。

四、常见业务场景的实现思路

4.1 RESTful API 调用

现代后端服务普遍采用 RESTful 架构。C# 客户端需要构建符合 REST 规范的请求，处理 JSON 序列化与反序列化，并管理认证令牌的生命周期。对于需要频繁调用的 API，建议封装为服务层，统一处理基础 URL、默认头信息和错误重试逻辑。

4.2 文件上传与下载

文件上传通常使用 multipart/form-data 格式，将文件流与表单字段一起打包发送。需要注意设置合理的超时时间，大文件上传可能需要分片或断点续传机制。
文件下载建议采用流式处理，将响应流直接写入本地文件系统，避免将整个文件加载到内存。对于大文件，可以实现进度回调，向用户展示下载进度。

4.3 身份认证集成

常见的认证方式包括：

4.4 异步与并发控制

HttpClient 原生支持异步操作，应始终使用 async/await 模式避免阻塞主线程。在高并发场景下，需要控制同时发出的请求数量，防止对目标服务器造成过大压力或触发限流。可以通过信号量（Semaphore）或 HttpClient 的连接池配置来实现并发控制。

五、超时、重试与容错设计

网络通讯天然不可靠，健壮的客户端必须考虑各种异常情况。

5.1 超时配置

HTTP 请求应设置合理的超时时间，包括：

5.2 重试策略

对于因网络抖动或服务器瞬时过载导致的失败，合理的重试机制可以提高成功率。重试策略应考虑：

5.3 熔断与降级

在微服务架构中，当依赖服务持续不可用时，客户端应启动熔断机制，快速失败而非持续等待，避免级联故障。同时可以准备降级方案，如返回缓存数据或默认值。

六、代码实现

6.1 Post请求

/// <summary>
/// HTTP POST请求
/// </summary>
/// <param name="url">请求地址</param>
/// <param name="value">参数</param>
/// <param name="timeout">超时时间,默认5秒</param>
/// <returns></returns>
public JObject Post(string url, string value, int timeout = 10)
{
    JObject result = new JObject();
    result["code"] = 99;
    result["message"] = "请求失败";
    try
    {
        HttpClient client = new HttpClient();
        HttpContent content = new StringContent(value);
        content.Headers.ContentType = new MediaTypeHeaderValue("application/json");
        // 数据转化为 key=val 格式
        //var content =  new FormUrlEncodedContent(value);
        //默认希望响应使用Json序列化(内容协商机制，我接受json格式的数据)
        client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
        client.Timeout = new TimeSpan(0, 0, timeout);
        // 发送请求
        var response = client.PostAsync(url, content);
        // 获取数据
        string message = response.Result.Content.ReadAsStringAsync().Result.ToString();
        result["code"] = 0;
        result["message"] = message;
    }
    catch (Exception ex)
    {
        result["code"] = 1;
    }
    return result;
}

6.2 Get请求

/// <summary>
/// HTTP Get请求
/// </summary>
/// <param name="url">请求地址</param>
/// <param name="timeout">超时时间,默认5秒</param>
/// <returns></returns>
public JObject Get(string url, int timeout = 10)
{
    JObject result = new JObject();
    result["code"] = 99;
    result["message"] = "请求失败";
    try
    {
        HttpClient client = new HttpClient();
        client.Timeout = new TimeSpan(0, 0, timeout);
        // 发送请求
        var response = client.GetAsync(url);
        // 获取数据
        string message = response.Result.Content.ReadAsStringAsync().ToString();
        result["code"] = 0;
        result["message"] = message;
    }
    catch (Exception ex)
    {
        result["code"] = 1;
    }
    return result;
}

6.3 DELETE请求

/// <summary>
/// HTTP DELETE请求
/// </summary>
/// <param name="url">请求地址</param>
/// <param name="timeout">超时时间,默认5秒</param>
/// <returns></returns>
public JObject Delete(string url, int timeout = 10)
{
    JObject result = new JObject();
    result["code"] = 99;
    result["message"] = "请求失败";
    try
    {
        HttpClient client = new HttpClient();
        client.Timeout = new TimeSpan(0, 0, timeout);
        // 发送请求
        var response = client.DeleteAsync(url);
        // 获取数据
        string message = response.Result.Content.ReadAsStringAsync().ToString();
        LogHelperUtility.Info(string.Format("[Delete]请求返回参数:{0}", message));
        result["code"] = 0;
        result["message"] = message;
    }
    catch (Exception ex)
    {
        result["code"] = 1;
    }
    return result;
}

七、性能优化要点

7.1 连接池管理

HttpClient 内部维护连接池，复用 TCP 连接可大幅减少握手开销。但连接池有数量上限，高并发场景下可能需要调整最大连接数配置。

7.2 压缩传输

启用请求和响应的 Gzip 压缩，可显著减少网络传输数据量。现代服务器和 HttpClient 均默认支持，只需确保客户端声明接受压缩编码。

7.3 请求管道定制

HttpClient 支持通过消息处理器（Delegating Handler）构建请求管道，可在管道中统一实现日志记录、认证注入、重试逻辑等横切关注点，避免在每个请求中重复编码。

7.4 DNS 缓存与刷新

长时间运行的应用程序可能遇到 DNS 变更问题。HttpClient 默认会缓存 DNS 解析结果，对于需要频繁切换后端节点的场景，可能需要配置 DNS 刷新策略。

八、安全注意事项

8.1 敏感信息保护

API 密钥、访问令牌等敏感信息不应硬编码在源代码中，应通过配置文件、环境变量或密钥管理服务（如 Azure Key Vault）获取。日志中应避免输出完整的认证头信息。

8.2 HTTPS 强制使用

生产环境必须使用 HTTPS 协议，确保数据传输的加密性和完整性。对于自签名证书的开发环境，需要谨慎配置证书验证策略，避免将不安全的验证逻辑带入生产代码。

8.3 请求伪造防护

如果客户端同时作为 Web 应用运行，需要注意防范 CSRF（跨站请求伪造）攻击。虽然纯 C# 客户端程序通常不受 CSRF 影响，但在混合应用场景中仍需保持警惕。

九、总结

C# 提供了成熟而强大的 HTTP 通讯能力，HttpClient 作为现代首选方案，通过异步设计、连接复用和管道扩展，能够满足绝大多数业务场景的需求。在实际开发中，开发者应关注请求构建的规范性、响应处理的完整性、异常场景的容错性以及安全传输的强制性。将 HTTP 通讯逻辑封装为可复用的服务组件，结合依赖注入和配置化管理，可以构建出既灵活又稳健的网络通讯层，为应用程序与外部世界的交互提供可靠保障。

以上就是C#中实现HTTP请求通讯的操作指南的详细内容，更多关于C#实现HTTP请求通讯的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:
阅读全文