C# API调用工具实战指南：从HttpClient到Refit的深度解析

1次阅读

没有评论

共计 2483 个字符，预计需要花费 7 分钟才能阅读完成。

在 C# 开发中，API 调用是几乎每个项目都会涉及的核心功能。然而，许多开发者在实际工作中会遇到一系列常见问题：

性能瓶颈 ：不当的连接池管理导致 TCP 端口耗尽，引发 SocketException
稳定性问题 ：缺乏重试机制时，网络抖动直接导致请求失败
维护困难 ：分散在各处的 API 调用代码难以统一管理
调试复杂度 ：缺乏标准化日志记录，问题定位耗时

这些痛点往往在项目规模扩大后集中爆发，特别是在微服务架构中，API 调用质量直接影响整个系统的 SLA。

优点：

.NET 官方库，无需第三方依赖
支持 HTTP/2
内置连接池管理

缺点：

需要手动处理 JSON 序列化
基础 API 较为底层

适用场景 ：简单项目或需要精细控制 HTTP 细节的场景

优点：

简洁的链式 API
自动处理序列化
丰富的插件生态

缺点：

性能开销较大
部分高级功能需要付费版

适用场景 ：快速原型开发或中小型项目

优点：

声明式接口定义
强类型安全
与 Rx.NET 完美集成

缺点：

学习曲线较陡
调试难度稍高

适用场景 ：大型项目或需要严格类型安全的场景

// 推荐使用 IHttpClientFactory 管理生命周期
var client = _httpClientFactory.CreateClient();

// 配置默认请求头
client.DefaultRequestHeaders.Add("Accept", "application/json");

// 执行 GET 请求
var response = await client.GetAsync("https://api.example.com/users");
response.EnsureSuccessStatusCode();

// 反序列化响应
var content = await response.Content.ReadAsStringAsync();
var users = JsonSerializer.Deserialize<List<User>>(content);

var client = new RestClient("https://api.example.com");
var request = new RestRequest("users", Method.Get);

// 添加查询参数
request.AddQueryParameter("page", "1");

// 自动反序列化
var response = await client.ExecuteAsync<List<User>>(request);
if (!response.IsSuccessful)
{throw new ApiException(response.ErrorMessage);
}

return response.Data;

// 定义接口
public interface IUserApi
{[Get("/users")]
    Task<List<User>> GetUsersAsync();}

// 创建实例
var userApi = RestService.For<IUserApi>("https://api.example.com");

// 直接调用
return await userApi.GetUsersAsync();

基于本地测试环境（16 核 32GB 内存）的基准测试结果：

工具	平均延迟 (ms)	最大 QPS	CPU 占用率
HttpClient	12.3	8,500	15%
RestSharp	23.7	4,200	28%
Refit	14.1	7,800	18%

关键发现：

HttpClient 在原生性能上具有明显优势
Refit 的类型安全几乎不带来性能损耗
RestSharp 在小批量请求时体验更友好

// 正确配置 HttpClient
services.AddHttpClient("apiClient")
    .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler
    {PooledConnectionLifetime = TimeSpan.FromMinutes(5) // 避免 DNS 刷新问题
    });

// 全局超时
client.Timeout = TimeSpan.FromSeconds(30);

// 单个请求超时
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(10));
await client.GetAsync(url, cts.Token);

推荐使用 Polly 实现智能重试：

services.AddHttpClient("retryClient")
    .AddPolicyHandler(GetRetryPolicy());

private static IAsyncPolicy<HttpResponseMessage> GetRetryPolicy()
{
    return HttpPolicyExtensions
        .HandleTransientHttpError()
        .WaitAndRetryAsync(3, retryAttempt => 
            TimeSpan.FromSeconds(Math.Pow(2, retryAttempt)));
}