惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

博客园 - 聂微东
GbyAI
GbyAI
G
Google Developers Blog
大猫的无限游戏
大猫的无限游戏
H
Hackread – Cybersecurity News, Data Breaches, AI and More
博客园 - 叶小钗
A
About on SuperTechFans
M
MIT News - Artificial intelligence
宝玉的分享
宝玉的分享
雷峰网
雷峰网
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
Martin Fowler
Martin Fowler
Google DeepMind News
Google DeepMind News
博客园 - Franky
B
Blog RSS Feed
Y
Y Combinator Blog
Stack Overflow Blog
Stack Overflow Blog
MongoDB | Blog
MongoDB | Blog
Last Week in AI
Last Week in AI
T
The Blog of Author Tim Ferriss
The GitHub Blog
The GitHub Blog
S
SegmentFault 最新的问题
罗磊的独立博客
Apple Machine Learning Research
Apple Machine Learning Research

博客园 - Eric zhou

Github Project-AI Agentic Framework (.NET) 我不是给 AI 装了一堆插件,我是在搭一套工作能力系统 我不是在用 AI 助手,我在把自己的能力沉淀成组织资产 .NET 10 新特性概览与相关文章索引 .NET 10 & C# 14 New Features 新增功能介绍-ASP.NET Core 基于Microsoft.Extensions.AI 和 Microsoft.Extensions.VectorData构建向量搜索 Windows 安装 OpenClaw 踩坑全记录:Node、Git、CMake、VS Build Tools 一次解决 .NET 10 & C# 14 New Features 新增功能介绍-.NET CLI工具改进 .NET 10 & C# 14 New Features 新增功能介绍-再看Top Level Program .NET 10 & C# 14 New Features 新增功能介绍-带修饰符的简单 lambda 参数 .NET 10 & C# 14 New Features 新增功能介绍-Null 条件分配(Null-conditional assignment) .NET 10 & C# 14 New Features 新增功能介绍-field关键字 .NET 10 & C# 14 New Features 新增功能介绍-扩展成员Extension Members 基于.NET和C#构建光伏IoT物模型方案 .NET 10 New feature 新增功能介绍-Minimal APIs增强 .NET 10 New feature 新增功能介绍-WebSocket功能增强 Google A2UI本地部署记录 .NET10 New feature 新增功能介绍-类库新增功能 关于Agentic AI的一些总结和思考 .NET10 New feature 新增功能介绍-JIT编译器改进
总结归纳.NET 10 中 Minimal APIs 主要应用场景
Eric zhou · 2026-01-13 · via 博客园 - Eric zhou

上一篇文章给大家分享了

.NET 10 New feature 新增功能介绍-Minimal APIs增强

今天继续分享, Minimal APIs 主要应用场景

在 .NET 6–8 中,Minimal APIs 已经完成了“能用”阶段;

.NET 9–10 的目标非常明确:让 Minimal APIs 成为企业级 API 的一等公民

核心增强方向可以概括为四个关键词: 

可维护、可治理、可扩展、可工程化

具体体现在以下能力成熟度提升:

  1. 更强的类型系统支持(Typed Results / OpenAPI 对齐)

  2. 更完善的过滤器与中间件组合能力

  3. 与 DI、Validation、Authorization 的深度融合

  4. 对 API 分层、模块化、规模化的原生支持

 我们继续对比思考传统 Controller 模型的典型问题:

image

 Minimal APIs 增强后的核心应用场景总结

 场景一:高并发读接口(数据服务 / 智能问数 / 看板接口)

首先是更强 Typed Results,彻底消除“返回不确定性”

app.MapGet("/stations/{id}",
    async Task<Results<Ok<StationDto>, NotFound, ProblemHttpResult>> 
    (long id, IStationService service) =>
{
    var station = await service.GetAsync(id);
    return station is null
        ? TypedResults.NotFound()
        : TypedResults.Ok(station);
});

这保证了

  • OpenAPI 文档 100% 精确

  • AI / 前端 / SDK 自动生成零歧义

  • 不再需要 [ProducesResponseType]

 极致轻量,避免 Controller 反射 & Filter 链成本,高 QPS 场景

  • Minimal APIs:

    • 路由直接绑定 Delegate

    • 少一层 MVC 管道

  • 对 CPU 与内存友好

只读接口 + 高频接口,优先 Minimal APIs

 场景二:业务能力型 API

 典型问题(Controller 模式)

  • 业务规则散落在 Attribute / Filter / Action

  • 授权、校验、审计难以统一.

NET 10 的解决方式:Endpoint Filter 工程化统一业务能力过滤器

public class OperatorContextFilter : IEndpointFilter
{
    public async ValueTask<object?> InvokeAsync(
        EndpointFilterInvocationContext ctx,
        EndpointFilterDelegate next)
    {
        // 解析运营商上下文
        OperatorContext.Current = Resolve(ctx.HttpContext);
        return await next(ctx);
    }
}

 应用到业务 API

app.MapGroup("/api/charge")
   .AddEndpointFilter<OperatorContextFilter>()
   .RequireAuthorization("OperatorPolicy")
   .MapPost("/start", StartCharge);

image

 场景三:平台级 API 模块化

 我们可以按 业务域 拆分 API,而不是 Controller:

public static class StationEndpoints
{
    public static IEndpointRouteBuilder MapStation(this IEndpointRouteBuilder app)
    {
        var group = app.MapGroup("/api/station")
            .RequireAuthorization();

        group.MapGet("/{id}", GetStation);
        group.MapPost("/", CreateStation);

        return app;
    }
}

Program.cs 极其灵活、简单做集成即可,这可以实现多业务线并行开发

app.MapStation();
app.MapOrder();
app.MapCharge();
app.MapFinance();

 场景四:内部微服务 / AI Agent 接口(非传统 REST)

 Minimal APIs 在 .NET 10 中,非常适合做 Agent Tool 接口

app.MapPost("/agent/charge/analyze",
    async (ChargeAnalyzeRequest req, IChargeAnalyzer analyzer) =>
{
    return TypedResults.Ok(await analyzer.AnalyzeAsync(req));
});

 场景五:BFF / API Gateway 层

 使用 Minimal APIs 可以实现

  • 聚合多个下游接口、业务逻辑编排

  • DTO 转换 + 协议适配

  • 极致简洁

app.MapGet("/bff/station/{id}",
    async (long id, IStationApi api, IPriceApi priceApi) =>
{
    var station = await api.Get(id);
    var price = await priceApi.GetPrice(id);
    return TypedResults.Ok(new StationView(station, price));
});

 以上是.NET 10 中 Minimal APIs 主要应用场景的总结和分享。

周国庆

2026/1/12