.NET 7中通配路由优先级错误高于已定义路由

我使用的是dotnet 7.0.203版本，遇到一个路由优先级问题：配置了若干明确路由和一条通配路由，期望通配路由拥有最低优先级，甚至尝试通过Route特性的Order属性强制设置优先级，但明确路由仍然被通配路由拦截。

相关文件片段如下：

• Startup.cs中的路由配置代码
• 包含通配路由的MController.cs——该路由会拦截所有请求
• 包含明确路由的RController.cs——其路由无法生效。访问localhost:{port}/api/randomized/xyz时，期望命中RController，但实际并未实现。

如果使用UseMvc并移除UseRouting，则能正常工作；但我希望使用新的端点路由方式，而非Mvc，求解决思路。

代码片段 #

Startup.cs #

public void ConfigureServices(IServiceCollection services)
{
    if (m_environment.IsDevelopment())
    {
        services.AddCors(options =>
        {
            options.AddPolicy("AllowSpecificOrigin",
                builder => builder.WithOrigins("http://localhost:3000")
                .AllowAnyHeader()
                .AllowAnyMethod());
        });
    }
    services.AddRouting();
    services.AddHttpContextAccessor();
    services.AddControllers().AddJsonOptions(options =>
    {
        options.JsonSerializerOptions.Converters.Add(new JsonStringEnumConverter());
    });
    services.AddSwaggerGen(ConfigureSwaggerGetOptions);
        // 其他服务注册
    }
}

public void Configure(IApplicationBuilder app)
{   
    app.UseRouting();

    app.UseCors("AllowSpecificOrigin");

    app.UseAuthentication();
    app.UseAuthorization();

    if (m_environment.IsDevelopment())
    {
        app.UseSwagger();
        app.UseSwaggerUI();
    }

    app.UseEndpoints(t =>
    {
        t.MapControllers();
    });
}

MController.cs（通配路由） #

public class MController: Controller
{
    [HttpGet("{*url}", Order = 1000)] // 通配路由，已设置Order为1000（期望最低优先级）
    [Produces(MediaTypeNames.Text.Html)]
    [ProducesResponseType(StatusCodes.Status200OK)]
    public async Task<ContentResult> SomeHtmlNotImportantAsync()
    {
        
    }
}

RController.cs（明确路由） #

[Route("api/randomized", Order = 1)] // 明确路由前缀，设置Order为1（期望高优先级）
[Consumes(MediaTypeNames.Application.Json)]
[Produces(MediaTypeNames.Application.Json)]
public class RController: Controller
{
    [HttpGet("{id}")] // 明确路由的具体路径
    [ProducesResponseType(StatusCodes.Status200OK)]
    public async Task<IActionResult> SomeActionAsync(string id)
    {
        // 业务逻辑
        return Ok(response);
    }
}

问题本质 #

ASP.NET Core端点路由系统中，Order属性的生效逻辑和传统Mvc不同：通配路由{*url}的匹配精度权重极高，会覆盖大部分路径匹配，单纯设置Action的Order不足以让明确路由优先；且控制器上的Route特性Order与Action的Order是分开计算的，无法直接通过控制器Order覆盖通配路由的匹配优先级。

具体解决方案 #

方案1：给通配路由添加路径排除约束 #

修改MController的通配路由，添加正则约束排除api/开头的路径，这样通配路由就不会拦截API请求：

public class MController: Controller
{
    // 添加正则约束，排除所有api/开头的路径
    [HttpGet("{*url}", Order = 1000, Constraints = new { url = @"^(?!api/).*$" })]
    [Produces(MediaTypeNames.Text.Html)]
    [ProducesResponseType(StatusCodes.Status200OK)]
    public async Task<ContentResult> SomeHtmlNotImportantAsync()
    {
        // 逻辑不变
    }
}

方案2：给API的Action显式设置更高优先级 #

在RController的Action上也添加Order属性，确保其优先级高于通配路由（注意：Order值越小，优先级越高）：

[Route("api/randomized", Order = 1)]
[Consumes(MediaTypeNames.Application.Json)]
[Produces(MediaTypeNames.Application.Json)]
public class RController: Controller
{
    // 给Action也设置Order=1，确保优先级高于通配路由的Order=1000
    [HttpGet("{id}", Order = 1)]
    [ProducesResponseType(StatusCodes.Status200OK)]
    public async Task<IActionResult> SomeActionAsync(string id)
    {
        // 业务逻辑
        return Ok(response);
    }
}

方案3：在端点路由中明确配置优先级顺序 #

修改UseEndpoints的配置，先映射API控制器，再注册通配路由，通过注册顺序控制优先级（注册顺序早的路由优先级更高）：

app.UseEndpoints(endpoints =>
{
    // 先映射RController的API路由，确保优先匹配
    endpoints.MapControllerRoute(
        name: "randomized-api",
        pattern: "api/randomized/{id}",
        defaults: new { controller = "R", action = "SomeActionAsync" },
        order: 1
    );

    // 再注册通配路由，优先级更低
    endpoints.MapControllerRoute(
        name: "catchall",
        pattern: "{*url}",
        defaults: new { controller = "M", action = "SomeHtmlNotImportantAsync" },
        order: 1000
    );

    // 保留其他控制器映射（如果需要）
    endpoints.MapControllers();
});

使用此方案时，需要移除MController和RController上的路由特性，改用端点配置来统一管理路由优先级。

内容的提问来源于stack exchange，提问作者Mavi Domates