简介:这是一款基于C#与WinForm开发的HTTP接口测试工具,面向需要调试API的开发者与C#学习者,可解决日常接口验证中快速发起请求、查看响应的问题。工具支持POST、GET、PUT、DELETE四种常见请求方法,能够填写请求体、设置请求头并展示状态码与响应内容,适合开发调试、接口联调及教学参考等场景。资源包共41个文件,以cs源码、config配置、exe可执行程序、csproj工程文件及resx资源文件为主,另含pdb调试符号与sln解决方案,整体约62KB,结构完整便于直接运行或二次开发。目前已有1443人学习下载。代码注释清晰、可读性较好,读者既能将其作为即用型接口调试工具,也能通过阅读源码理解WinForm界面与HTTP通信的实现方式,对学习C#网络编程与桌面应用开发具有参考价值。
1. 一个 C# 接口测试工具,为什么值得自己动手写
线上联调最怕的不是接口报错,而是你手里没有一个能立刻发请求、看响应、改参数的工具。浏览器地址栏只能发 GET,Postman 装完还要登录账号,团队里想统一一份测试用例又得付费。于是很多人动了自己用 C# 写一个接口测试工具的念头——支持 POST、GET、PUT、DELETE 四种请求,能填 URL、请求头、请求体,点一下就能看到状态码和返回内容。这个方向对 C# 开发者来说性价比很高: HttpClient 是官方库, WinForms 或 WPF 拖几个控件就能出界面,一两天能跑通最小版本。它适合两类人:一类是日常要调 REST 接口的后端和上位机开发者,另一类是想通过一个真实小项目把 C# 网络编程、异步、委托这几块串起来的学习者。下面我按自己实际做过的路径,把选型、请求封装、界面联动和踩过的坑讲清楚。
2. 请求方法怎么封装:HttpClient 的四种 Method 落地
2.1 为什么选 HttpClient 而不是 HttpWebRequest
.NET 里发 HTTP 请求有两条路:老的 HttpWebRequest 和新的 HttpClient 。 HttpWebRequest 在 .NET Framework 时代是主力,但它的 API 偏底层,每次都要手动处理流、编码、连接释放,写四个方法会重复大量代码。 HttpClient 从 .NET 4.5 开始提供,天然支持异步、连接池复用、请求头统一管理,而且 HttpRequestMessage 允许你在运行时动态指定 HttpMethod ,这意味着 POST、GET、PUT、DELETE 可以共用一套发送逻辑,只在构造请求时换一个 Method 对象。
我一般会用一个 HttpClient 单例,而不是每次请求都 new 。原因是 HttpClient 内部维护连接池,频繁创建会导致 socket 耗尽,这个坑在批量压测时特别明显。单例的写法:
// 全局唯一的 HttpClient,避免频繁创建导致 socket 耗尽
private static readonly HttpClient _client = new HttpClient
{
// 默认超时 30 秒,可按接口实际情况调整
Timeout = TimeSpan.FromSeconds(30)
};
参数说明: Timeout 控制单次请求的最长等待时间,接口慢就调大,但不要设成无限,否则界面会一直卡在等待状态。如果你要测的是内网接口,30 秒足够;如果是跨地域调用,可以放到 60 秒。
2.2 用 HttpRequestMessage 统一四种请求
核心思路是把「方法、URL、头、体」四样东西组装成一个 HttpRequestMessage ,再交给 HttpClient.SendAsync 。GET 和 DELETE 通常不带请求体,POST 和 PUT 需要带 Body。下面是一个可以直接抄的发送方法:
public static async Task<string> SendAsync(
string method, // "GET" / "POST" / "PUT" / "DELETE"
string url, // 完整请求地址
string body, // 请求体,GET/DELETE 传 null
Dictionary<string, string> headers) // 自定义请求头
{
// 根据字符串创建对应的 HttpMethod
var request = new HttpRequestMessage(new HttpMethod(method), url);
// POST/PUT 才需要写 Body,GET/DELETE 跳过
if (!string.IsNullOrEmpty(body) &&
(method == "POST" || method == "PUT"))
{
// 默认按 JSON 发送,字符集用 UTF-8
request.Content = new StringContent(
body, Encoding.UTF8, "application/json");
}
// 逐个添加自定义请求头,比如 Authorization、Cookie
if (headers != null)
{
foreach (var kv in headers)
{
// Content 相关的头要加到 Content 上,其余加到 request 上
if (!request.Headers.TryAddWithoutValidation(kv.Key, kv.Value))
{
request.Content?.Headers.TryAddWithoutValidation(kv.Key, kv.Value);
}
}
}
// 发送并读取响应文本
var response = await _client.SendAsync(request);
string result = await response.Content.ReadAsStringAsync();
// 把状态码拼在结果前面,方便界面直接展示
return $"{(int)response.StatusCode} {response.StatusCode}\r\n{result}";
}
逻辑说明: new HttpMethod(method) 把界面传来的字符串转成方法对象,这样四种请求走同一条代码路径。 TryAddWithoutValidation 用于添加非标准头,避免因为头格式校验抛异常。状态码拼在返回文本最前面,是为了让界面不用再单独解析。
参数说明: body 只在 POST/PUT 时使用,GET 传 null 即可; headers 用字典传入,键值对就是请求头的名字和值。注意 Content-Type 这类头如果直接加到 request.Headers 会失败,代码里已经做了回退到 Content.Headers 的处理。
2.3 异步调用与界面线程的配合
WinForms 里如果直接在按钮事件里 .Result 或 .Wait() ,界面会假死。正确做法是事件处理器标 async ,然后 await 发送方法:
private async void btnSend_Click(object sender, EventArgs e)
{
// 禁用按钮,防止重复点击
btnSend.Enabled = false;
try
{
// 从界面控件读取参数
string method = cboMethod.Text;
string url = txtUrl.Text;
string body = txtBody.Text;
var headers = ParseHeaders(txtHeaders.Text);
// 异步发送,await 期间界面保持响应
string result = await HttpHelper.SendAsync(method, url, body, headers);
txtResponse.Text = result;
}
catch (Exception ex)
{
// 网络异常统一在这里兜底
txtResponse.Text = "请求失败:" + ex.Message;
}
finally
{
btnSend.Enabled = true;
}
}
await 会把耗时操作放到线程池,完成后自动回到 UI 线程更新控件,这是 WinForms 里最省心的写法。 ParseHeaders 是你自己写的一个小方法,把多行文本按「键: 值」拆成字典,注意冒号后面可能有空格,要 Trim 。
3. 界面与参数联动:让工具真正好用
3.1 方法切换时控件该显示什么
四种请求对界面的要求不一样。GET 和 DELETE 不需要请求体,POST 和 PUT 需要。如果不管选什么都显示请求体输入框,用户会困惑。我的做法是在方法下拉框的 SelectedIndexChanged 事件里控制请求体区域的可见性:
private void cboMethod_SelectedIndexChanged(object sender, EventArgs e)
{
// 只有 POST 和 PUT 需要请求体
bool needBody = cboMethod.Text == "POST" || cboMethod.Text == "PUT";
lblBody.Visible = needBody;
txtBody.Visible = needBody;
}
这样切换方法时界面立刻反馈,减少误填。请求头区域则始终显示,因为 GET 也经常需要带 Authorization 或 Cookie 。
3.2 请求头的解析与常见格式
请求头输入框一般让用户一行写一个头,格式是 Key: Value 。解析时要注意几个细节:空行跳过、冒号只切第一个、值两边的空格去掉。下面是一个稳妥的解析方法:
private Dictionary<string, string> ParseHeaders(string raw)
{
var dict = new Dictionary<string, string>();
if (string.IsNullOrWhiteSpace(raw)) return dict;
// 按行拆分,兼容 \r\n 和 \n
var lines = raw.Split(new[] { "\r\n", "\n" },
StringSplitOptions.RemoveEmptyEntries);
foreach (var line in lines)
{
// 只切第一个冒号,避免值里含冒号被切错
int idx = line.IndexOf(':');
if (idx <= 0) continue;
string key = line.Substring(0, idx).Trim();
string val = line.Substring(idx + 1).Trim();
if (key.Length > 0) dict[key] = val;
}
return dict;
}
参数说明: IndexOf(':') 只找第一个冒号,这样 Authorization: Bearer abc:def 这种值里带冒号的头也能正确解析。 RemoveEmptyEntries 跳过空行,避免用户多敲回车导致异常。
3.3 响应展示与状态码着色
响应区域如果只是一坨纯文本,排查效率低。我习惯把状态码单独提出来,2xx 显示绿色、4xx 显示橙色、5xx 显示红色。实现上可以在拿到结果后解析第一行:
// result 第一行是 "200 OK" 这种格式
var firstLine = result.Split('\n')[0].Trim();
if (firstLine.StartsWith("2")) txtResponse.ForeColor = Color.Green;
else if (firstLine.StartsWith("4")) txtResponse.ForeColor = Color.Orange;
else if (firstLine.StartsWith("5")) txtResponse.ForeColor = Color.Red;
else txtResponse.ForeColor = Color.Black;
这个改动很小,但联调时一眼就能看出请求是成功还是失败,比逐行读返回内容快得多。
4. 避坑与排查:四个真实翻过车的地方
4.1 中文请求体乱码
现象:POST 发送含中文的 JSON,服务端收到的是乱码。原因: StringContent 默认编码不一定是 UTF-8,或者服务端按 GBK 解析。解决:构造 StringContent 时显式传 Encoding.UTF8 ,并在请求头里确认 Content-Type 带 charset=utf-8 。如果服务端只认 GBK,就把 Encoding.UTF8 换成 Encoding.GetEncoding("GBK") ,但这种情况现在很少见。
4.2 请求头加不进去抛异常
现象:调用 request.Headers.Add("Content-Type", "application/json") 直接抛 InvalidOperationException 。原因: Content-Type 、 Content-Length 属于内容头,必须加到 request.Content.Headers 上,不能加到 request.Headers 。解决:用 TryAddWithoutValidation 并做回退,先试 request.Headers ,失败再试 request.Content.Headers ,这也是 2.2 节代码里那样写的原因。
4.3 界面卡死无响应
现象:点发送后窗口拖动不了,像死机。原因:在 UI 线程上同步等待异步方法,比如写了 SendAsync(...).Result 。解决:事件处理器改成 async void ,用 await 调用,绝不在 UI 线程上阻塞等待。如果某个老代码必须同步,至少用 Task.Run 包一层,但优先改异步。
4.4 HTTPS 证书校验失败
现象:请求内网自签名 HTTPS 接口时报「基础连接已关闭」或证书错误。原因: HttpClient 默认校验证书链,自签名证书过不了。解决:如果确认是内网可信环境,可以在 HttpClientHandler 里放宽校验,但生产环境不要这么做:
var handler = new HttpClientHandler
{
// 仅用于内网自签名证书调试,生产环境务必去掉
ServerCertificateCustomValidationCallback =
(msg, cert, chain, errors) => true
};
var client = new HttpClient(handler);
注意:这段代码只适合本地调试,正式工具里应该保留校验,让用户导入受信任证书。
5. 进阶技巧:把单次请求变成可复用的测试用例
工具能发单次请求只是起点,真正省时间的是把常用请求存下来批量跑。我的习惯是在界面上加一个「保存用例」按钮,把方法、URL、头、体序列化成 JSON 存到本地文件,下次直接加载。序列化用 System.Text.Json 就够:
public class ApiCase
{
public string Method { get; set; }
public string Url { get; set; }
public string Body { get; set; }
public Dictionary<string, string> Headers { get; set; }
}
// 保存
string json = JsonSerializer.Serialize(apiCase,
new JsonSerializerOptions { WriteIndented = true });
File.WriteAllText(path, json);
// 加载
var loaded = JsonSerializer.Deserialize<ApiCase>(
File.ReadAllText(path));
存成 JSON 的好处是可读、可版本管理,团队里可以直接放进 Git 共享。批量跑的时候遍历用例列表,逐个 await SendAsync ,把结果汇总到一个表格里。这里有个细节:批量跑不要并发太高,内网接口一般 5 到 10 个并发就够,太高会把测试环境打挂,反而看不出问题。
再进一步,可以把断言也加进去。比如用例里存一个「期望状态码」字段,跑完对比实际状态码,不一致就标红。这样工具就从「手动发请求」变成了「轻量回归测试」,每次改完接口跑一遍,比人肉点一遍可靠得多。
我自己做这类工具最大的教训是:一开始总想功能全,结果界面越堆越乱,最后自己都不想用。后来砍到只留方法、URL、头、体、响应五个区域,反而天天在用。先把最小闭环跑通,再按实际痛点加功能,这个顺序别反。希望帮到你。
2943



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



