17370845950

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 路由。不需要重造轮子时，它足够快、够轻、够直接。