HttpListener 是 C# 原生轻量 Web 服务器方案,无需 IIS 或 Kestrel,支持 .NET Framework 和 .NET 5+;需管理员权限注册 URL 前缀(如 http://localhost:8080/),核心步骤为创建监听器、添加前缀、调用 GetContext() 或 GetContextAsync() 处理请求,注意异常捕获、资源释放与并发处理。

用 C# 实现一个简单的 Web 服务器,HttpListener 是最轻量、无需 IIS 或 Kestrel 的原生方案,适合调试、内网工具或嵌入式场景。它不依赖 ASP.NET Core,.NET Framework 和 .NET 5+ 都支持(注意权限和前缀注册)。
基础用法:监听并响应一个 GET 请求
核心步骤就三步:创建监听器、添加 URL 前缀、启动监听并处理上下文。
必须以管理员权限运行(Windows 上注册 http://localhost:8080/ 等前缀需要)URL 前缀格式为 "http://localhost:8080/",末尾斜杠不能省调用 GetContext() 是阻塞的,收到请求才返回;可用 GetContextAsync() 配合 async/await
示例代码:
var listener = new HttpListener();listener.Prefixes.Add("http://localhost:8080/");listener.Start();Console.WriteLine("服务器已启动,访问 http://localhost:8080");while (true){var ctx = listener.GetContext(); // 阻塞等待请求var response = ctx.Response;var buffer = Encoding.UTF8.GetBytes("Hello from HttpListener!");response.ContentLength64 = buffer.Length;response.OutputStream.Write(buffer, 0, buffer.Length);response.Close();}
支持多种 HTTP 方法和路径路由
ctx.Request.HttpMethod 和 ctx.Request.Url.LocalPath 可做简单路由判断。
区分 GET /api/data 和 POST /submit,用 if 判断即可读取 POST 数据:用 ctx.Request.InputStream + StreamReader(注意编码)设置响应状态码:response.StatusCode = 404;,响应头:response.Headers["Content-Type"] = "application/json";
例如返回 JSON:
if (ctx.Request.HttpMethod == "GET" && ctx.Request.Url.LocalPath == "/api/time"){ var json = $"{{"time":"{DateTime.Now:O}"}}"; var buffer = Encoding.UTF8.GetBytes(json); response.ContentType = "application/json"; response.ContentLength64 = buffer.Length; response.OutputStream.Write(buffer, 0, buffer.Length);}
安全与健壮性要点
实际使用不能只写 while(true),要注意异常、资源释放和并发。
把 GetContext() 放在 try/catch 中,避免一次异常导致服务中断监听器停止时调用 listener.Stop() 和 .Close()每个响应必须调用 response.Close(),否则连接可能挂起如需并发处理多个请求,建议用线程池或 Task.Run() 分发上下文,避免阻塞主线程
注册 URL 前缀(Windows 必做)
首次运行常报错“拒绝访问”,是因为系统没授权该用户监听该地址。打开管理员命令行执行:
netsh http add urlacl url=http://localhost:8080/ user=Everyone// 或指定当前用户名(推荐)netsh http add urlacl url=http://+:8080/ user="%USERDOMAIN%%USERNAME%"
撤销命令是 netsh http delete urlacl url=http://localhost:8080/。用 + 表示绑定所有网卡(注意防火墙)。
基本上就这些。HttpListener 不复杂但容易忽略权限和资源释放,跑通后可封装成小工具类,比如带日志、静态文件服务或简单 API 路由。不需要重造轮子时,它足够快、够轻、够直接。
以上就是C#怎么实现一个简单的Web服务器 C# HttpListener使用方法的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1443056.html
微信扫一扫
支付宝扫一扫