ASP.NET Core 6中使用RouteEndpointBuilder设置Minimal API路由的优先级顺序

你遇到的核心问题是：直接用RouteEndpointBuilder创建的端点，其优先级没有被Minimal API的路由系统正确识别，导致两个同路径端点的InboundPrecedence完全一致，进而引发冲突。下面给你两种可靠的解决方案，帮你实现按Order值控制路由触发顺序：

方案一：通过WithMetadata设置端点优先级 #

Minimal API支持用WithMetadata扩展方法，直接为端点添加RouteEndpointMetadata来指定优先级（Order值越小，优先级越高）。修改你的代码如下：

// 先定义两个处理函数示例
async Task<IResult> getUser1(HttpContext context)
{
    return Results.Ok("来自getUser1的响应");
}

async Task<IResult> getUser2(HttpContext context)
{
    return Results.Ok("来自getUser2的响应");
}

// 为第一个端点设置更高优先级（Order=1）
app.Map("/api/v1/users", getUser1)
   .WithMetadata(new RouteEndpointMetadata(1));

// 第二个端点优先级更低（Order=2）
app.Map("/api/v1/users", getUser2)
   .WithMetadata(new RouteEndpointMetadata(2));

这样设置后，当请求/api/v1/users时，路由系统会优先匹配Order值更小的getUser1，不会触发getUser2。

方案二：利用HTTP方法区分（如果业务场景允许） #

如果这两个端点本来就是处理不同的HTTP请求方法（比如一个处理GET、一个处理POST），可以直接用Minimal API提供的MapGet、MapPost等方法，这样天然不会产生冲突：

// GET请求触发getUser1
app.MapGet("/api/v1/users", getUser1);

// POST请求触发getUser2
app.MapPost("/api/v1/users", getUser2);

这种方式比手动设置优先级更清晰，也符合RESTful API的设计规范。

为什么原来的方法不生效？ #

你直接用RouteEndpointBuilder创建端点后调用app.Map，Minimal API的路由构建逻辑并没有正确继承你设置的Order值。Minimal API有自己的端点构建流程，推荐使用官方提供的扩展方法（如WithMetadata）修改端点元数据，才能被路由系统正确识别优先级。

内容的提问来源于stack exchange，提问作者Sana.91