Skip to content
HttpAgent
首页
文档
工坊
博客
Furion
Ctrl K
EN
开始上手
1.1 HTTP 远程请求概述
1.2 安装与注册服务
1.3 在 Claude Code / Codex 中使用（llms.txt）
推荐
1.4 与其他 HTTP 客户端库对比
1.5 关于作者
1.6 更新日志
v2.2.0
快速入门
2.1 获取网站内容
2.2 携带请求数据
2.3 Form 表单提交（URL 编码）
2.4 下载网络资源
2.5 上传文件资源（OSS）
2.6 HTTP 声明式请求（代理方式）
推荐
2.7 请求分析工具
推荐
2.8 添加授权凭证
2.9 设置 Cookie（模拟/自动登录）
2.10 异常处理（异常抑制）
2.11 压力与模拟测试（性能测试）
2.12 长轮询 Long Polling
2.13 Server-Sent Events 单向通信
2.14 WebSocket 双工通信
2.15 HttpContext 转发和代理
2.16 WebService 接口请求（SOAP）
2.17 从 cURL 命令发送
2.18 从 JSON 发送
2.19 OData 接口请求
2.20 HTTP 请求与响应断言（Assert）
2.21 JSON 响应反序列化包装器
2.22 Access Token 自动管理
2.23 接口调用配额限制
2.24 服务发现（ServiceDiscovery）
2.25 HttpRemoteResult<TResult> 返回类型
2.26 DeepSeek 官方对接
2.27 抓取网页内容（爬虫）
2.28 httpbin.org 在线测试服务
请求构建器
3.1 HttpRequestBuilder 请求构建器
3.2 创建构建器实例
3.3 设置请求地址
3.4 方法命名原则
3.5 设置跟踪标识
3.6 设置内容类型
3.7 设置内容编码
3.8 设置 JSON 内容
3.9 设置 HTML 内容
3.10 设置 XML 内容
3.11 设置文本内容
3.12 设置原始 raw 字符串内容
3.13 设置 URL 编码表单内容
3.14 设置文件内容
3.15 设置二进制流内容
3.16 设置请求内容（Body）
3.17 设置 MCP/2.0 消息内容
3.18 设置多部分表单内容
3.19 设置请求标头
3.20 设置移除的请求标头
3.21 设置片段标识符
3.22 设置超时时间
3.23 配置重试策略
3.24 设置路径片段
3.25 设置移除的路径片段
3.26 设置查询参数（URL 参数）
3.27 设置移除的查询参数
3.28 设置路径参数（模板/配置参数）
3.29 设置 Cookie
3.30 设置移除的 Cookies
3.31 设置 HttpClient 实例的名称（多个基地址）
3.32 设置响应内容的最大缓存大小
3.33 设置 HttpClient 实例提供器
3.34 添加请求内容处理器
3.35 添加响应内容转换器
3.36 启用 HttpClient 池化管理
3.37 添加请求结束时需释放的资源
3.38 管理和释放资源
3.39 设置添加请求内容前的操作
3.40 设置发送请求前的操作
3.41 设置收到响应后的操作
3.42 设置发送请求失败时的处理
3.43 确保请求成功
3.44 设置 Basic 身份认证
3.45 设置 Bearer 身份认证（JWT）
3.46 设置 Digest 摘要身份认证
3.47 设置自定义身份认证
3.48 禁用 HTTP 缓存
3.49 设置请求处理程序
3.50 模拟浏览器环境（爬虫检测）
3.51 添加响应状态码处理程序
3.52 启用请求分析工具
3.53 设置客户端偏好的语言和区域
3.54 设置 HttpRequestMessage 属性
3.55 启用标准请求标头
3.56 设置自动 Host 标头
3.57 配置请求基地址
3.58 配置来源地址 Referer
3.59 配置 User-Agent
3.60 配置 HTTP 版本
3.61 异常抑制机制（静默处理）
3.62 移除内容的默认 Content-Type
3.63 条件化配置构建器
3.64 启用断言功能
3.65 配置断言逻辑
3.66 启用 JSON 响应反序列化包装器
3.67 响应 JSON 双重序列化处理
3.68 设置在构建最终请求 URL 的操作
3.69 设置重定向时进行额外配置
3.70 清除请求内容
3.71 追加请求内容
3.72 禁用 Access Token 自动管理
3.73 设置 Access Token 请求的自定义数据
3.74 移除 URL 地址末尾的 /
3.75 设置请求接口配额键
3.76 启用 ETag 响应缓存
3.77 设置 SOAP 请求头（WebService）
3.78 模拟请求响应与异常（Mock）
3.79 克隆和复制
3.80 设置自定义数据
3.81 获取请求构建器或请求消息（预检请求）
3.82 HttpRequestBuilder 统一配置器
3.83 自定义 HttpRequestBuilder 扩展方法
3.84 自定义扩展其他构建器
多部分表单构建器
4.1 HttpMultipartFormDataBuilder 表单构建器
4.2 创建构建器实例
4.3 设置内容边界
4.4 保留内容的默认 Content-Type
4.5 添加单个表单项内容
4.6 添加 JSON 内容
4.7 添加 HTML 内容
4.8 添加 XML 内容
4.9 添加文本内容
4.10 添加对象内容（复杂表单/上传文件）
4.11 添加互联网文件内容
4.12 添加 Base64 字符串文件内容
4.13 添加本地路径文件内容（进度）
4.14 添加 Stream 内容
4.15 添加字节数组内容
4.16 添加 MultipartFile 内容
4.17 添加 IFormFile 和 IFormFileCollection 内容
4.18 添加 IBrowserFile 和 IEnumerable<IBrowserFile> 内容
4.19 添加 FileInfo 内容
4.20 添加 URL 编码表单内容
4.21 添加多部分表单内容
4.22 添加 HttpContent 内容
4.23 设置添加表单项内容前的操作
4.24 设置表单名称策略（转换器）
4.25 设置多部分表单内容项的排序规则
4.26 添加 HttpMultipartFormDataBuilder 扩展
声明式请求
5.1 HTTP 声明式请求
5.2 接口定义与使用
5.3 定义请求方法
5.4 定义请求地址
5.5 同步与异步方法
5.6 定义返回值类型
5.7 设置跟踪标识
5.8 设置超时时间
5.9 配置重试策略
5.10 设置路径片段
5.11 设置查询参数（URL 参数）
5.12 设置请求标头
5.13 设置路径参数（模板/配置参数）
5.14 设置 Cookie
5.15 设置 HttpClient 实例的名称（多个基地址）
5.16 设置请求内容（Body）
5.17 设置多部分表单内容（复杂表单/上传文件）
5.18 禁用 HTTP 缓存
5.19 确保请求成功
5.20 模拟浏览器环境（爬虫检测）
5.21 启用请求分析工具
5.22 设置客户端偏好的语言和区域
5.23 设置 HttpRequestMessage 属性
5.24 启用标准请求标头
5.25 设置自动 Host 标头
5.26 设置请求基地址
5.27 设置来源地址（防盗链）
5.28 配置 HTTP 版本
5.29 异常抑制机制（静默处理）
5.30 启用参数验证
5.31 启用 JSON 响应反序列化包装器
5.32 响应 JSON 双重序列化处理
5.33 设置请求处理程序
5.34 禁用 Access Token 自动管理
5.35 移除 URL 地址末尾的 /
5.36 设置请求接口配额键
5.37 启用 ETag 响应缓存
5.38 继承与复用
5.39 冻结参数类型
5.40 获取请求构建器或请求消息（预检请求）
5.41 自定义 HTTP 声明提取器
5.42 自定义 HTTP 声明提取器（授权）
5.43 HttpDeclarativeBuilder 构建器（动态构建）
进阶指南
IHttpContentProcessor 内容处理器
6.1 IHttpContentProcessor 内容处理器
6.2 内置内容处理器
6.3 IHttpContentProcessorFactory 内容处理器工厂
6.4 自定义内容处理器（如序列化）
6.5 添加 MessagePack 支持
6.6 添加 Protobuf 支持
IHttpContentConverter 内容转换器
6.7 IHttpContentConverter 内容转换器
6.8 内置内容转换器
6.9 IHttpContentConverterFactory 内容转换器工厂
6.10 IObjectContentConverterFactory 对象内容转换器工厂
6.11 自定义对象内容转换器（如序列化）
6.12 自定义内容转换器
6.13 自定义泛型内容转换器
IHttpRemoteService 服务
6.14 IHttpRemoteService 服务
6.15 HttpRemoteBuilder 构建器
6.16 HttpRemoteOptions 配置选项
6.17 统一配置 HttpClient 客户端
6.18 内置属性与方法
6.19 添加 IHttpRemoteService 扩展
HttpRemoteResult<TResult> 返回值
6.20 HttpRemoteResult<TResult> 返回值
下载网络资源
6.21 下载网络资源
6.22 HttpFileDownloadBuilder 构建器
6.23 文件传输事件处理程序
上传文件资源
6.24 上传文件资源
6.25 HttpFileUploadBuilder 构建器
6.26 文件传输事件处理程序
压力与模拟测试
6.27 压力与模拟测试
6.28 HttpStressTestHarnessBuilder 构建器
长轮询 Long Polling
6.29 长轮询 Long Polling
6.30 HttpLongPollingBuilder 构建器
6.31 长轮询事件处理程序
6.32 终止长轮询请求
Server-Sent Events 单向通信
6.33 Server-Sent Events 单向通信
6.34 HttpServerSentEventsBuilder 构建器
6.35 Server-Sent Events 事件处理程序
WebSocket 双工通信
6.36 WebSocket 双工通信
6.37 WebSocketClient 客户端
HttpContext 转发和代理
6.38 HttpContext 转发和代理
6.39 HttpContextForwardBuilder 构建器
6.40 HttpContextForwardOptions 配置选项
6.41 HttpContext 转发扩展方法
6.42 HttpContext 转发的优势
6.43 HttpContext 转发在微服务中的应用
6.44 转发忽略标头说明
6.45 ForwardAttribute 转发特性
HTTP 请求管道处理器
6.46 HTTP 请求管道处理器
FTP 客户端功能展望
6.47 FTP 客户端功能展望
CancellationToken 取消 HTTP 请求
6.48 CancellationToken 取消 HTTP 请求
HttpClient 实例配置
6.49 HttpClient 实例配置
6.50 常见属性配置
6.51 配置 IHttpClientBuilder
6.52 配置 SSL 证书
6.53 配置 Proxy 代理服务器
6.54 配置 HTTP/3 支持
6.55 HttpClientOptions 扩展配置（JSON 序列化）
6.56 服务解析配置
6.57 了解更多配置
DelegatingHandler 请求处理委托（拦截）
6.58 DelegatingHandler 请求处理委托（拦截）
6.59 DelegatingHandler 应用场景
6.60 自定义 DelegatingHandler
6.61 实现自动刷新授权 Token
HttpClientHandler 发送请求底层处理器
6.62 HttpClientHandler 发送请求底层处理器
6.63 HttpClientHandler 的核心功能
6.64 与 DelegatingHandler 的协作关系
6.65 自定义 HttpClientHandler
6.66 最佳实践建议
RateLimitedStream 带速率限制的流
6.67 RateLimitedStream 带速率限制的流
FileTypeMapper 文件 MIME 类型映射
6.68 FileTypeMapper 文件 MIME 类型映射
JwtTokenUtility 解析 JWT Token
6.69 JwtTokenUtility 解析 JWT Token
DigestCredentials 摘要身份认证
6.70 DigestCredentials 摘要身份认证
HTTP 请求日志（关闭）
6.71 HTTP 请求日志（关闭）
应用案例
7.1 应用案例
7.2 使用流变对象 Clay 构建和接收请求数据
7.3 在 Blazor WebAssembly 应用中使用
7.4 在 File-Based Apps 应用中使用
7.5 在 MAUI 应用中使用
常见问题
8.1 常见问题
8.2 忽略 SSL 证书验证（https 错误）
8.3 发送请求出现长时间挂起或阻塞
8.4 强制 IPv4 或 IPv6 请求
8.5 重定向响应处理
8.6 启用标准请求标头
8.7 设置默认 User-Agent
8.8 发送相对地址（内部）请求
8.9 获取响应 Cookie
8.10 配置 Windows 身份认证
8.11 配置 Kerberos 和 Active Directory 身份认证
8.12 响应内容解压（支持 gzip、deflate、brotli 和 zstd）和内容乱码处理
8.13 JSON 序列化配置
8.14 禁用分布式跟踪上下文（traceparent 标头）
8.15 设置 Content-Type（MIME）
8.16 在非依赖注入环境中使用（Console/WinForms/WPF）
8.17 并行请求（批量下载）
8.18 使用 LoadIntoBufferAsync 缓存响应内容
8.19 与旧版 Java 程序提供的 API 对接
8.20 AddHttpRemote 二义性错误
8.21 反馈与建议
/
文档
/
常见问题
/
常见问题
8.1
常见问题
更新于 2026 年 8 月 21 日
·
约 1 分钟读完
这里汇总了一些发送
HTTP
远程请求时可能遇到的常见问题。
上一篇
7.5
在 MAUI 应用中使用
下一篇
8.2
忽略 SSL 证书验证（https 错误）