HttpAgent 正式发布：内置工业级 HTTP 流量分析引擎

我们很高兴宣布，HttpAgent 正式发布。这是一个面向 .NET 8+ 的高性能、灵活、易用的 HTTP 开源库，为文件传输、轮询、测试工具、实时通信、请求管理、媒体类型处理、MessagePack、声明式请求等场景提供全面支持。

为什么需要 HttpAgent#

对接第三方 API 时，开发者最头疼的问题是什么？看不见请求到底发出去什么、响应到底返回了什么。传统做法是打开 Fiddler 或 Wireshark 抓包，配置代理、装证书、过滤流量——一套流程下来，调试五分钟，配置半小时。

HttpAgent 内置了工业级 HTTP 流量分析引擎（Profiler），直接在控制台呈现完整请求/响应报文：

1
2

await httpRemoteService.GetAsync("https://furion.net/",    builder => builder.Profiler());   // 一行代码开启请求分析

控制台将输出请求头、响应头、状态码、耗时等全部细节，无需任何外部工具。

核心能力一览#

• 全谓词支持：GET、POST、PUT、DELETE、PATCH、HEAD、TRACE、OPTIONS、QUERY；
• 文件传输：上传/下载、实时进度、多线程分片下载；
• 实时通信：SSE、WebSocket、标准/长轮询；
• 韧性治理：重试（指数退避）、超时控制、异常抑制，可扩展熔断降级；
• Token 自动管理：自动刷新、自动注入、401 自动重试；
• 配额与缓存：日/周/月/永久配额窗口、ETag 响应缓存；
• 声明式请求：接口 + 特性注解，支持继承与面向对象设计；
• cURL 导入：从 cURL 命令字符串直接发起请求；
• 压力测试：内置压测工具，自动生成测试报告。

一分钟上手#

dotnet add package HttpAgent

1
2
3
4
5
6
7

builder.Services.AddHttpRemote();   // 注册服务public class YourService(IHttpRemoteService httpRemoteService){    public async Task<string?> GetContent()        => await httpRemoteService.GetAsStringAsync("https://furion.net/");}

更完整的渐进式学习路径，请从 HttpAgent 简介 开始阅读。

致谢#

项目在 Gitee 公开托管，欢迎 Star、Issue 与 PR。后续我们将持续更新实战教程与最佳实践，敬请关注博客动态。