如何记录.NET Core 6 HttpClient请求以适配Postman Mock服务测试

1. 从NSwag生成的客户端代码直接获取请求格式 #

打开NSwag生成的HttpClient类文件，定位到对应接口的调用方法：

• 查看方法内的PostAsync/PutAsync等调用逻辑，明确请求的HTTP方法、路由模板（是否包含路径参数、查询参数）。
• 检查参数的序列化方式（NSwag默认使用System.Text.Json或Newtonsoft.Json），以及代码中自动添加的默认请求头（比如Content-Type: application/json）。
• 关注方法参数上的特性标记，比如[Route]定义的路径参数、[Query]定义的查询参数，这些直接决定了请求的URL结构。

2. 在WinForm中手动拦截并记录完整请求 #

微软ASP.NET Core的HTTP日志不适用WinForm场景，可自定义Handler捕获请求全量信息：

• 编写继承自HttpClientHandler的日志拦截类：

public class LoggingHandler : HttpClientHandler
{
    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        // 输出请求方法与URL
        Console.WriteLine($"请求: {request.Method} {request.RequestUri}");
        
        // 输出所有请求头
        foreach (var header in request.Headers)
        {
            Console.WriteLine($"{header.Key}: {string.Join(", ", header.Value)}");
        }
        
        // 输出请求体（若存在）
        if (request.Content != null)
        {
            var body = await request.Content.ReadAsStringAsync(cancellationToken);
            Console.WriteLine($"请求体: {body}");
        }
        
        return await base.SendAsync(request, cancellationToken);
    }
}

• 使用该Handler创建HttpClient并初始化NSwag生成的客户端：

var httpClient = new HttpClient(new LoggingHandler())
{
    BaseAddress = new Uri("你的Mock服务地址")
};
// 将此httpClient传入NSwag生成的客户端构造函数

运行WinForm调用接口后，控制台会输出完整请求信息，直接复制这些内容到Postman即可创建匹配的Mock示例。

3. 让NSwag直接生成Postman兼容的请求集合 #

NSwag原生支持导出Postman请求集合，无需手动拼接：

• 打开NSwagStudio，加载原始的Swagger/OpenAPI JSON文件。
• 在输出选项中选择Postman Collection，将BaseUrl设置为你的Mock服务地址，按需配置其他选项。
• 点击生成并导出JSON格式的集合文件。
• 打开Postman导入该集合，里面的请求格式完全匹配生成的HttpClient，直接用这些请求创建Mock示例即可。

4. 查看原始OpenAPI规范文件 #

如果你的原始JSON是Swagger/OpenAPI规范，直接打开文件查看paths节点：

• 找到对应接口的定义，其中的requestBody、parameters、headers字段就是标准请求格式，按照该格式在Postman中拼接请求即可。

内容的提问来源于stack exchange，提问作者Banshee