简介:这是一款由C#语言编写的HTTP接口测试工具,采用WinForm窗体框架开发,支持POST、GET、PUT、DELETE四种核心请求方法。面向后端开发与接口调试人员,可帮助快速验证API接口的返回状态码、响应数据格式及请求响应性能,也适合C#初学者学习网络请求与桌面程序开发。资源包共41个文件,压缩后约62KB,以13个.cs源码文件、6个config配置、3个exe可执行程序以及csproj、sln等工程文件构成,rar包内项目结构完整,解压后可通过Visual Studio直接编译运行。目前已有1444人学习使用。工具界面涵盖URL地址填写、请求类型选择、请求头与JSON请求体配置、响应结果展示等交互环节,代码注释清晰,逻辑层次明确,既可直接作为常规接口联调工具,也能作为参考模板扩展二次开发,对接口测试人员日常查证问题和C#开发者研究WinForm与HTTP通信均有实用价值。
1. C# WinForms 接口测试工具:GET、POST、PUT、DEL 一次调明白
调接口这事,C# 开发者难免有工具焦虑:Postman 顺手,但内网接口的证书、编码、超时问题一碰,还是得回到代码里反复试。这个 C# WinForms 接口测试工具把 GET、POST、PUT、DEL 四种请求收进一个窗体,URL、请求头、请求体、响应状态码和耗时全部可视,不需要浏览器,也不依赖额外 UI 库。适合两类人:一类是刚开始做 C# 上位机或 Web 后端联调、想快速验证接口参数的人;另一类是天天对着接口文档改代码、想省掉“复制 URL、改参数、看响应”这套重复动作的熟手。下面按请求模型、四类请求落地、避坑、日志重放的顺序展开,照着做一遍,这个工具就能在你自己的项目里落了地。
2. 先把请求模型立起来:URL 拼接、方法分发与 WinForms 场景下的选型
2.1 为什么 WinForms 扛得住:一个窗体能装完整个请求流程
做接口测试工具,第一反应可能是控制台程序,一行命令带上 URL 和请求体打出来,简单直接。但控制台有两个硬伤:改 Header 和 Body 要端起命令行参数拼字符串,响应太长时阅读体验极差;再一个是没法保存一组常用请求,每次联调都是新起一个进程。WinForms 的优势在于把一个请求需要的全部输入都放在一个窗体上:URL 输入框、方法下拉框、Header 编辑区、Body 编辑区和响应区,五个控件一摆,请求闭环就建立了。
我实际用过 WPF 做同类工具,后来退回 WinForms。团队里 .NET Framework 3.5/4.x 的老项目还占大头,WinForms 直接从工具箱拖控件,运行时不依赖额外 UI 库,内网机器上拷过去就能跑。加上这个工具只处理一个窗口的业务,WinForms 在启动速度和部署成本上的优势非常明显。
一个我坚持的习惯是:工具的请求参数一律存储在内存对象里,界面只是展示层。这样后续加“重新发送上次请求”“保存请求模板”时,不需要去 TextBox 里反解字符串,数据迭代顺很多。
2.2 请求封装:HttpClient 与 HttpWebRequest 的取舍,以及我选的那套
.NET 里发起 HTTP 请求有两套常用方案:HttpWebRequest 和 HttpClient。HttpWebRequest 是 .NET Framework 早期就有的老接口,方法命名偏过程式,写起来比较啰嗦,但不需要引入任何额外依赖。HttpClient 在 .NET 4.5 之后加入,支持 async/await、连接复用、独立的超时属性,代码上更简洁。
我一般会优先选 HttpClient。注意在简单工具里,用 using 创建短生命周期实例完全可以接受;如果是大量并发请求,再改成长生命周期的单例。Windows 上老版本 .NET Framework 还要注意 TLS 配置,HttpClient 默认使用的安全协议可能连不上仅支持 TLS 1.2 的服务器,需要设置 ServicePointManager.SecurityProtocol。这在联调场景里尤其常见,因为很多内网服务器还停留在 TLS 1.0/1.1。
核心请求封装我放在一个私有方法里,返回一个结果对象而不是直接返回字符串。这样状态码、耗时和响应正文一次拿到,界面只负责展示:
private async Task<HttpResult> SendRequestCoreAsync(string url, string method,
string body, string contentType, int timeoutSeconds)
{
using (var client = new HttpClient())
{
client.Timeout = TimeSpan.FromSeconds(timeoutSeconds);
using (var request = new HttpRequestMessage(new HttpMethod(method), url))
{
if (!string.IsNullOrEmpty(body))
{
request.Content = new StringContent(body, Encoding.UTF8, contentType);
}
Stopwatch sw = Stopwatch.StartNew();
HttpResponseMessage response = await client.SendAsync(request);
string content = await response.Content.ReadAsStringAsync();
sw.Stop();
return new HttpResult
{
StatusCode = (int)response.StatusCode,
Body = content,
ElapsedMilliseconds = sw.ElapsedMilliseconds
};
}
}
}
这里有四个关键点:第一,new HttpMethod(method) 是唯一需要区分方法的地方,下拉框传进来的字符串在四类请求上通用。第二,StringContent 的第三个参数是 Content-Type,由外部传入,这样 JSON 和表单场景可以复用同一个方法。第三,Stopwatch 放在 SendAsync 外面、ReadAsStringAsync 之前,记录的是完整的请求加响应耗时。第四,返回值用自定义的 HttpResult 类,后续新增字段时不用改方法签名。
HttpResult 的定义顺手写一下:
public class HttpResult
{
public int StatusCode { get; set; }
public string Body { get; set; }
public long ElapsedMilliseconds { get; set; }
}
这类小类放在 WinForms 项目里单独建一个 Models 文件夹,保持界面代码和请求代码分离。界面上渲染历史列表时会直接用这个类,比 DataTable 减掉一半代码。
2.3 方法分发与 URL 处理:从下拉框到请求实体的最小路径
方法分发不需要写 switch。界面上一个 ComboBox,Items 写死四个字符串:GET、POST、PUT、DEL。但注意 HTTP 标准动词是 DELETE,所以发送按钮读取下拉框后要做一次映射:
string method = comboMethod.SelectedItem.ToString();
if (method == "DEL") method = "DELETE";
string content = ...;
var result = await SendRequestCoreAsync(url, method, content, contentType, timeout);
这样界面尊重项目里“DEL”的叫法,协议层又不发非标准动词。后续要支持 PATCH、HEAD,只需要在 Items 里加一项,代码不用动。
URL 处理要分两层:合法性检查和查询参数拼接。合法性用 Uri.TryCreate 校验:
if (!Uri.TryCreate(baseUrl, UriKind.Absolute, out Uri uri))
{
MessageBox.Show("URL 格式不合法,需要以 http:// 或 https:// 开头");
return;
}
检查一个细节: out Uri uri 里 uri 即使未赋值也能作为 out 参数。UriKind.Absolute 很重要,相对地址不能作为接口请求地址,第二版工具加了这个校验之后,至少少了一类“请求地址忘加协议头”的弱智报错。
查询参数拼接我推荐用 SortedDictionary 而不是普通 Dictionary,因为很多内网接口要求参数按 key 字典序排序后参与签名。排序、过滤空 Key、转码一次做完:
private string BuildSortedQuery(SortedDictionary<string, string> parameters)
{
return string.Join("&",
parameters.Where(p => !string.IsNullOrEmpty(p.Key))
.Select(p => Uri.EscapeDataString(p.Key) + "=" + Uri.EscapeDataString(p.Value ?? "")));
}
参数说明:Where 过滤空 Key,p.Value ?? "" 避免 null 拼进 URL 直接抛异常,Uri.EscapeDataString 负责把中文和特殊字符转成 %XX。这里有个坑很多人踩:不要用 HttpUtility.UrlEncode 做 query 编码,它会把空格编码成“+”,而 GET 的 query 里服务端解析出的空格就变成加号了。这个区别在联调时非常隐蔽。
3. 把四类请求做扎实:GET、POST、PUT、DEL 的请求体、响应解析与参数细节
3.1 GET 与 DELETE:传参方式不同,坑也不同
GET 的参数在 URL 上,POST 的参数在请求体里,这是两者最基础的区别,也是工具布局的起点。工具里 URL 输入框允许直接写带问号的完整地址,查询参数表格中填的键值对则追加到已有 query 之后,两个入口互不覆盖。追加时用上面的 BuildSortedQuery,把查询参数表格的内容转成 query string 拼到现 URL 上,服务端两种写法都能正常解析。
DELETE 请求要特别说明:HTTP 规范允许带请求体,但很多服务端框架根本不读 DELETE 的 body。常见做法是把要删除的资源标识放在 URL 上。所以第二版工具把 DELETE 的请求体编辑区默认禁用,改用查询参数区传递资源 ID,避免开发者被“DELETE 能带 body 吗”这个问题反复纠缠。这个决定基于对接过几十个接口后的经验:与其支持一个半吊子的 DELETE body,不如引导走用户量更大的 query 模式。
GET 和 DELETE 共用一个查询参数拼接逻辑,但 GET 还有一个隐藏问题:URL 长度限制。老一点的 IIS 或 Tomcat 配置对 GET 请求有长度上限,参数一多就返回 414。工具在发送前会做一个简单判断,查询参数拼出来的 URL 长度超过 8000 字符时给出提示,提醒“这个接口可能更适合用 POST 提交”。这个提示救过不少同事的命。
3.2 POST 与 PUT:JSON 和表单的 Content-Type 要分开处理
POST、PUT 的请求体在工具里做成一个下拉框,支持两种类型:application/json 和 application/x-www-form-urlencoded。选 JSON 时,请求体编辑区直接写 JSON 文本,工具原样提交;选表单时,同一个编辑区按“每行一个 key=value”的规则填写,工具在发送前统一做转码再拼接。这样一个输入区服务两种格式,界面不需要新增控件。
这里最重要的一条经验:Content-Type 必须和实际请求体格式一致。最常见的翻车是 body 里写了 JSON,Content-Type 却选了 form,服务端接收到后取不到字段,返回 415 或空对象。工具的做法是把 Content-Type 和 body 一起封装进 StringContent,在界面上展示时也把它们作为一组相邻配置,从习惯上避免错位。
POST 与 PUT 在工具层面的差别只有一个方法名。多数项目里 PUT 是整体替换,POST 是新增,但请求体的构造逻辑完全复用,不需要为 PUT 单独开分支。JSON 场景的构造:
private HttpContent CreateJsonContent(string jsonText)
{
return new StringContent(jsonText ?? "", Encoding.UTF8, "application/json");
}
表单场景的构造:
private string BuildFormBody(Dictionary<string, string> formData)
{
return string.Join("&", formData.Select(kv =>
Uri.EscapeDataString(kv.Key) + "=" + Uri.EscapeDataString(kv.Value ?? "")));
}
两段代码的用途截得比较清楚。StringContent 在指定 application/json 时不需要手动加 charset,它在 HTTP 层自动带出 utf-8;表单场景必须手动 EscapeDataString,因为它并没有像 JSON 那样有序列化器兜底。表单编码这里有一个常见误用:UrlEncode 处理的字符串会和 StringContent 的编码机制产生二义性,参数值里含中文时服务端解析结果经常对不上。
3.3 响应区:状态码、耗时、JSON 一键格式化
响应区要解决的问题有三个:状态码和耗时一眼可见、JSON 可读、老数据不要刷屏。前两个用文本框顶部叠加状态行实现,第三个用截断策略。格式化 JSON 不需要自己写解析器,用 Newtonsoft.Json 的 JObject.Parse,解析失败说明服务端返回的是一段 HTML 错误页,原样展示即可:
private string FormatResponse(string rawBody)
{
if (string.IsNullOrWhiteSpace(rawBody)) return rawBody;
try
{
return JObject.Parse(rawBody).ToString(Formatting.Indented);
}
catch (JsonReaderException)
{
return rawBody;
}
}
说明:JsonReaderException 捕获非 JSON 内容;Formatting.Indented 生成带缩进的文本,粘贴到记事本也不会乱。状态码和耗时那行直接拼在正文前面:“HTTP 200,耗时 321ms”。状态码大于等于 400 时把这一行标红,一眼就能看出来哪个接口挂了。
响应头目前不在第一版展示范围,因为工具的核心诉求是验证参数和返回结构。但 HttpResult 类里预留了字段,后面想加响应头展示时不需要改发送方法,只改界面那层。
4. 避坑清单:编码、乱码、卡死与证书校验的五个翻车现场
工具能跑通只是第一步,下面五条是我实际复现这个项目时踩过的,每条按现象、原因、解决三步说明,参数可以直接照着抄。
4.1 中文乱码:响应里全是问号和“锟斤拷”
现象:接口返回的中文在响应区变成“??”或“锟斤拷”一类乱码。
原因:服务端用 GBK/GB2312 编码输出数据,但 HttpResponseMessage.Content.ReadAsStringAsync 默认按 UTF-8 解析。HttpClient 不会自动去探测响应编码,即使拿到 Content-Type 里的 charset 也经常是错的。
解决:先读原始字节,再用界面指定的编码解码:
byte[] bytes = await response.Content.ReadAsByteArrayAsync();
string text = Encoding.GetEncoding(encodingName).GetString(bytes);
encodingName 从 ComboBox 读取,默认 UTF-8,备选 GB2312、GBK。这里补一句:工具如果是 .NET Framework 4.x 写的,GetEncoding("GB2312") 直接可用;如果目标框架是 .NET 6/8 的 Windows Forms,需要引用 System.Text.Encoding.CodePages 并调用 Encoding.RegisterProvider。这个区别搜一下就能找到,但真正踩到的时候容易懵很久。
4.2 点击发送界面假死:窗体拖不动,标题栏“未响应”
现象:点击发送后,窗体无法拖动,标题栏显示“未响应”,请求完成后才恢复。
原因:在按钮 Click 事件里用了同步的 HttpWebRequest 方法,或者对 HttpClient 的异步方法调用了 .Result / .Wait(),阻塞了 UI 线程的消息循环。
解决:事件改成 async void,内部 await 网络调用。async void 是 WinForms 事件处理器唯一合法的异步写法,但异常必须自己包住:
private async void btnSend_Click(object sender, EventArgs e)
{
btnSend.Enabled = false;
try
{
var result = await SendRequestCoreAsync(...);
txtResponse.Text = FormatResponse(result.Body);
}
catch (Exception ex)
{
txtResponse.Text = "请求失败: " + ex.Message;
}
finally
{
btnSend.Enabled = true;
}
}
这里有两个细节:await 之后代码会回到 UI 线程上下文,所以直接赋值 txtResponse.Text 是安全的,不需要 Invoke;但是如果用 Task.Run 再把结果拿回 UI 线程,就必须要检查控件的 IsHandleCreated,否则窗体关闭瞬间会抛 ObjectDisposedException。
4.3 HTTPS 自签名证书校验失败
现象:请求抛出“AuthenticationException: 根据验证过程,远程证书无效”,或者“未能建立 SSL/TLS 安全通道”。
原因:内网接口常用自签名证书,开发机没有把证书装进受信任的根证书存储区。第一次看到这个报错还以为是服务器挂了,其实是握手阶段证书校验过不去。
解决:调试阶段通过 ServicePointManager.ServerCertificateValidationCallback 对指定域名放行,把这个开关放到配置里,默认关闭:
private void ToggleDebugCert(bool enabled)
{
if (enabled)
{
ServicePointManager.ServerCertificateValidationCallback +=
(sender, cert, chain, errors) =>
errors == SslPolicyErrors.None ||
(cert != null && cert.Subject.Contains("tools.test.local"));
}
else
{
ServicePointManager.ServerCertificateValidationCallback = null;
}
}
提示:这个配置只应该在测试环境打开,上线前检查“允许不受信任证书”这个开关必须为 false。不要写一个无条件 return true 的全局委托,否则生产环境也跳过证书校验,这个隐患比接口报错严重得多。
4.4 回车键误触发送:在 Header 里敲回车,请求莫名其妙发出去了
现象:焦点在 Header 或 Body 编辑框,只是想换行,请求却直接发出去了。
原因:Form 的 AcceptButton 属性设置成了发送按钮,WinForms 会把回车键自动路由到那个按钮上。
解决:把 AcceptButton 置空,如果需要键盘快捷键,用 KeyDown 判断 Ctrl+Enter 再触发:
public FrmMain()
{
InitializeComponent();
this.AcceptButton = null;
txtBody.KeyDown += CtrlEnterSend;
}
private void CtrlEnterSend(object sender, KeyEventArgs e)
{
if (e.Control && e.KeyCode == Keys.Enter)
{
btnSend.PerformClick();
}
}
注意多行 TextBox 的 AcceptReturn 默认是 true,回车会换行,和 AcceptButton 的行为叠加后很容易让人以为哪里死循环了。把 AcceptButton 置空之后,误触发送的问题直接消失。
4.5 响应太大:几 MB 数据把界面和内存同时拖死
现象:接口返回几 MB 的列表数据,界面渲染卡顿数秒,内存占用明显上升。
原因:TextBox 渲染大文本开销很大,几 MB 字符串直接塞给 Text 属性,UI 线程几乎冻结。
解决:预览区只展示前 100KB,完整响应写入文件。这个策略需要截断和写文件配合:
const int MaxPreview = 100 * 1024;
string preview = responseBody;
if (preview.Length > MaxPreview)
{
preview = preview.Substring(0, MaxPreview) + Environment.NewLine + "...(已截断,完整响应见日志文件)";
SaveFullResponse(responseBody);
}
写文件也要放在后台线程里,不然界面还是会被文件 I/O 堵住。这个工具里我直接用了 async 的 File.WriteAllTextAsync,一行代码解决问题。
5. 进阶用法:请求日志落盘与一键重放,让接口回归不再手工核对
工具调到能用只算完成一半,真正让它产生复利的是加一层请求日志和一键重放。每发送一次请求,就把 URL、方法、Headers、Body、状态码、耗时存成一个 JSON 文件。文件按时间戳命名,放在可执行文件目录下的 logs 文件夹里。隔几天再调接口时,不用回忆上次填了什么参数,直接翻日志。
日志对象定义如下:
public class RequestLogItem
{
public string Url { get; set; }
public string Method { get; set; }
public string Headers { get; set; }
public string Body { get; set; }
public int StatusCode { get; set; }
public long ElapsedMs { get; set; }
public string Time { get; set; }
}
保存代码:
private void SaveRequestLog(RequestLogItem item)
{
string dir = Path.Combine(Application.StartupPath, "logs");
Directory.CreateDirectory(dir);
string file = Path.Combine(dir, $"req_{DateTime.Now:yyyyMMdd_HHmmss}.json");
File.WriteAllText(file, JsonConvert.SerializeObject(item, Formatting.Indented));
}
Application.StartupPath 保证日志落在程序目录下,不污染系统路径;Formatting.Indented 让日志文件能直接用编辑器打开阅读。
重放逻辑更简单:读取 logs 目录下按创建时间倒序排第一的那个文件,反序列化成 RequestLogItem,然后把它重新提交一次。这里有一个关键点:日志里保存的是请求参数的原始文本,重放时不需要从界面的 TextBox 反推状态,直接把日志对象传给 SendRequestCoreAsync,整个代码路径和手动发送完全一致。重放时可以和上一次状态码对比,不同就标红,相同但 Body 不同时把两次响应存成两个文件,用对比工具看差异。
从那以后,我每次改完服务端接口,都会强制走一遍重放流程:选择最近一次请求,点重放并对比状态码,确认没有变化才合代码。这个习惯救过我几次,尤其是有人偷偷改了查询参数的排序规则时。希望帮到你。
8476



被折叠的 条评论
为什么被折叠?



