HttpListener 不适合生产环境，因不支持 HTTPS 终止、连接复用不稳定、无法平滑重启，且 .NET 6+ 已标记为“仅限内部使用”；应改用 Kestrel。
别用 HttpListener 做生产 HTTP 服务器 —— 它不支持 HTTPS 终止、连接复用不稳定、无法平滑重启，且 .NET 6+ 已标记为“仅限内部使用”。
为什么 HttpListener 不适合实际项目
很多人搜“C# HTTP 服务器”第一反应是 HttpListener，但它本质是个底层网络监听器，不是 Web 服务器。你得自己解析 HTTP 报文、处理路由、管理线程、应对慢连接、防范请求头注入……这些本该由成熟框架兜底的事，全推给业务代码。
常见翻车点：
-
HttpListener在 Windows Server 上默认限制并发连接数（通常 100），超限直接拒绝，错误日志只显示“拒绝访问”，不提示真实原因 - 收到带空格的
Host头（如Host: example.com）会抛InvalidOperationException，但异常堆栈不暴露原始请求，调试困难 - 无法绑定到
localhost:80除非以管理员权限运行，而生产环境严禁长期用管理员跑服务
用 Kestrel 搭建最小可用 HTTP 服务（.NET 6+）
Kestrel 是 .NET 官方推荐、跨平台、高性能的内置 Web 服务器，开箱即用，无需额外 NuGet。它默认启用连接池、HTTP/2 支持、请求体大小限制和防 DoS 配置。
最简启动方式（控制台程序）：
var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();
<p>app.MapGet("/", () => "Hello from Kestrel!");
app.Run();</p>
关键点：
- 端口由
builder.Configuration.GetConnectionString("HttpPort")或环境变量ASPNETCORE_URLS=http://*:5000控制，不要硬编码http://localhost:5000—— Docker 容器内 localhost 不指向宿主机 - 若需监听 IPv4 特定地址（如只响应内网请求），改用
builder.WebHost.UseUrls("http://192.168.1.100:5000")，但优先走配置文件 -
MapGet是路由捷径；复杂路由请用app.MapControllers()+[ApiController]，否则路径参数（如/user/{id}）无法自动绑定
需要静态文件或中间件？加一行 UseStaticFiles()
默认 Kestrel 不提供文件服务。要托管 wwwroot 下的 HTML/CSS/JS，必须显式启用：
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddStaticFiles(); // ← 注册服务
<p>var app = builder.Build();
app.UseStaticFiles(); // ← 启用中间件（顺序重要！必须在 UseRouting 之后、UseEndpoints 之前）</p><p>app.MapGet("/", () => "OK");
app.Run();</p>
注意顺序陷阱：
- 如果把
app.UseStaticFiles()放在app.UseRouting()之前，所有请求（包括 API）都会先查磁盘文件，导致 404 误判 - 静态文件路径默认映射到项目根目录下的
wwwroot；想换位置，用new StaticFileOptions { FileProvider = new PhysicalFileProvider("path/to/assets") } - 浏览器缓存由
Cache-Control响应头控制，默认不设，每次都是 200；如需强缓存，配合app.UseStaticFiles(new StaticFileOptions { OnPrepareResponse = ctx => { ctx.Context.Response.Headers.Append("Cache-Control", "public,max-age=31536000"); } })
部署时绕不开的反向代理问题
直接暴露 Kestrel 到公网有风险：它不校验 Host 头、不压缩响应、不防慢速攻击。生产必须前置 Nginx / Apache / IIS。
典型 Nginx 配置片段：
location / {
proxy_pass http://127.0.0.1:5000;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection keep-alive;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
对应 C# 代码里必须启用转发头解析，否则 Request.Scheme 永远是 http，生成的绝对 URL 全错：
- 在
Program.cs添加builder.Services.Configure(options => { options.ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto; }); - 在
app.UseForwardedHeaders();必须放在app.UseRouting()之前，否则中间件链拿不到修正后的头信息 - 如果 Nginx 和 Kestrel 不在同一机器，
X-Forwarded-For可能被伪造，务必用options.KnownNetworks.Clear(); options.KnownProxies.Add(IPAddress.Parse("192.168.1.5"));锁定可信代理 IP
真正麻烦的从来不是“怎么跑起来”，而是“怎么不让它在凌晨三点崩掉”。比如 Kestrel 默认单请求最大体 30MB，上传大文件直接 413；又比如没配 app.UseExceptionHandler()，未捕获异常会让整个 Kestrel 进程退出 —— 这些细节比“怎么写第一个 Hello World”重要得多。
