minimal api 默认高并发友好，基于kestrel和异步管道，复用线程池与i/o完成端口；需避免阻塞代码、共享状态竞争，正确使用async/await、concurrentdictionary、连接池，并配置kestrel参数及限流熔断。
Minimal API 默认就是高并发友好的
ASP.NET Core Minimal API 基于 Kestrel 和 Task-based 异步管道构建，底层复用 ThreadPool 和 I/O 完成端口（Windows）或 epoll/kqueue（Linux/macOS），只要你不写阻塞代码（比如 Task.Wait()、Result、Thread.Sleep()），它天然能支撑数千并发连接。瓶颈通常不出在框架层，而出在你的业务逻辑、IO 调用或资源争用上。
避免同步阻塞和共享状态竞争
常见误操作会让 Minimal API 在高并发下迅速退化为串行处理：
- 在
MapGet或MapPost处理函数里调用HttpClient.GetStringAsync().Result—— 会死锁或耗尽线程池 - 用静态字段或
static readonly Dictionary<string object></string>缓存数据但没加锁 ——ArgumentException: An item with the same key has already been added或数据错乱 - 直接 new
SqlConnection但没用using或没启用连接池（实际默认开启，但显式关闭Pooling=false就会崩）
正确做法是全程 async/await，缓存用 ConcurrentDictionary 或 MemoryCache，数据库连接靠连接池自动复用。
合理配置 Kestrel 和连接生命周期
默认 Kestrel 配置适合开发，生产需调整关键参数：
-
MaxConcurrentConnections：Linux 下可设为null（不限制），但建议结合 ulimit 控制 -
KeepAliveTimeout：默认 2 分钟，短连接场景可降到 30 秒减少空闲连接堆积 -
RequestHeadersTimeout：防止慢速 HTTP 攻击，设为 15–30 秒较稳妥 - 禁用
UseHttpsRedirection()（若已由前置 LB 终止 HTTPS），减少 TLS 握手开销
var builder = WebApplication.CreateBuilder(args);
builder.WebHost.ConfigureKestrel(serverOptions =>
{
serverOptions.Limits.MaxConcurrentConnections = null;
serverOptions.Limits.KeepAliveTimeout = TimeSpan.FromSeconds(30);
serverOptions.Limits.RequestHeadersTimeout = TimeSpan.FromSeconds(20);
});
用中间件做轻量级限流和熔断
Minimal API 不自带限流，但可以零依赖接入 Microsoft.AspNetCore.RateLimiting（.NET 7+）：
- 按 IP 或用户 ID 限流，防爬虫或误调用
- 用
TokenBucketRateLimiter比滑动窗口更省内存 - 配合
AddConcurrencyLimiter防止下游 DB/Redis 过载（例如限制最多 100 个并发 DB 查询）
注意：限流策略必须注册在 builder.Services 中，且中间件顺序要在 app.UseRouting() 之后、app.Map* 之前。
builder.Services.AddRateLimiter(options =>
{
options.AddTokenBucketLimiter("fixed", opt =>
{
opt.TokenLimit = 100;
opt.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
opt.QueueLimit = 20;
opt.ReplenishmentPeriod = TimeSpan.FromSeconds(1);
opt.TokensPerPeriod = 20;
});
});
// ... 在 app.Build() 后
app.UseRateLimiter();
app.MapGet("/api/data", () => "ok").RequireRateLimiting("fixed");
真正卡住高并发的，往往不是路由注册方式，而是你查一次 DB 就等 200ms、缓存没命中就全量扫表、或是日志写磁盘用了 File.AppendAllText。Minimal API 的轻量只放大了这些细节问题——它不替你做性能优化，只确保不拖后腿。
