在C#的网络编程场景中，HttpClient是发送HTTP请求的常用组件，而HttpClientHandler作为HttpClient的底层处理程序，提供了对请求和响应流程的干预能力，通过自定义HttpClientHandler可以轻松实现HTTP请求的拦截与修改。
HttpClientHandler的基本作用
HttpClientHandler是HttpClient的默认消息处理程序，负责实际处理HTTP请求的发送和响应的接收。它的内部提供了多个可重写的虚方法，允许开发者在请求处理的不同阶段插入自定义逻辑，其中最常用的就是SendAsync方法，该方法会在每次HTTP请求发送时被调用。
自定义HttpClientHandler实现请求拦截修改
要实现请求的拦截和修改，只需要继承HttpClientHandler类，重写SendAsync方法，在方法内部对传入的HttpRequestMessage对象进行处理，再调用基类的SendAsync方法完成后续请求流程即可。
基础实现示例
以下是一个简单的自定义HttpClientHandler示例，实现了添加自定义请求头、修改请求URI的功能：
using System;
using System.Net.Http;
using System.Threading;
using System.Threading.Tasks;
// 自定义HttpClientHandler类
public class CustomHttpClientHandler : HttpClientHandler
{
// 重写SendAsync方法，拦截并处理请求
protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
{
// 1. 拦截请求，添加自定义请求头
request.Headers.Add("X-Custom-Request", "CustomHandlerDemo");
// 2. 修改请求URI，示例：给原URI添加自定义查询参数
var originalUri = request.RequestUri;
var newUri = new Uri(originalUri + (originalUri.Query.Length > 0 ? "&" : "?") + "custom_param=test");
request.RequestUri = newUri;
// 3. 可以在此处记录请求相关信息，比如请求方法、URI等
Console.WriteLine($"拦截到请求：{request.Method} {request.RequestUri}");
// 调用基类的SendAsync方法，继续完成请求发送流程
var response = await base.SendAsync(request, cancellationToken);
// 4. 可以在此处对响应进行处理，比如记录响应状态码
Console.WriteLine($"请求响应状态码：{response.StatusCode}");
return response;
}
}
使用自定义HttpClientHandler发送请求
定义好自定义Handler之后，只需要将其传入HttpClient的构造函数，就可以让HttpClient使用我们自定义的处理逻辑：
class Program
{
static async Task Main(string[] args)
{
// 创建自定义HttpClientHandler实例
var handler = new CustomHttpClientHandler();
// 将handler传入HttpClient构造函数
using (var client = new HttpClient(handler))
{
try
{
// 发送GET请求，实际请求会被handler拦截修改
var response = await client.GetAsync("https://ipipp.com/api/test");
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine($"响应内容：{content}");
}
catch (Exception ex)
{
Console.WriteLine($"请求发生异常：{ex.Message}");
}
}
}
}
常见修改场景与注意事项
常见修改场景
- 添加统一的认证请求头，比如Bearer Token、API Key等，避免在每个请求中重复编写添加逻辑
- 修改请求参数，比如对请求参数进行加密、统一添加时间戳等
- 记录请求和响应的日志，方便排查接口调用问题
- 实现请求重试逻辑，当请求失败时自动重试指定次数
注意事项
- HttpClientHandler的实例是线程安全的，建议将其作为单例使用，避免频繁创建销毁带来性能损耗
- 重写
SendAsync方法时，一定要调用基类的SendAsync方法，否则请求无法实际发送 - 如果需要对响应内容进行修改，需要注意响应内容可能是流形式，需要正确处理流的读取和重置，避免影响后续逻辑
- 自定义Handler中不要编写过于耗时的同步逻辑，避免阻塞请求线程
总结
通过自定义HttpClientHandler并重写SendAsync方法，我们可以灵活地拦截和修改C#中的HTTP请求，满足各种自定义处理需求。这种方式侵入性低，统一了所有通过对应HttpClient发送的请求的处理逻辑，非常适合在项目中实现统一的请求处理规则。开发者可以根据实际业务场景，在自定义Handler中扩展更多个性化的处理逻辑。
C#_HttpClientHandlerHTTP请求拦截HTTP请求修改HttpClient修改时间：2026-07-15 03:00:21