.NET 8 Minimal API动态路由不生效问题排查与解决

问题根源 #

核心问题是中间件注册顺序错误：app.UseRouting()的调用时机早于自定义路径修改逻辑，导致路由系统已基于原始请求路径完成匹配，后续修改Request.Path无法对路由产生影响。

正确实现方式 #

将自定义路径修改中间件放在UseRouting()之前，确保路由系统读取修改后的路径：

// 先执行路径修改逻辑：提取URL最后一段作为新请求路径
app.Use(async (context, next) => {
    var requestPath = context.Request.Path.Value;
    var lastSlashIndex = requestPath.LastIndexOf('/');
    // 提取最后一个斜杠后的部分作为目标路径
    context.Request.Path = requestPath[lastSlashIndex..];
    await next();
});

// 再初始化路由系统
app.UseRouting();
app.MapControllers();

为什么之前的尝试失败 #

1. 自定义中间件方案：UseRouting()先执行时，路由匹配已提前完成，后续修改Request.Path无法触发重新路由，自然不会命中目标控制器。
2. DynamicRouteValueTransformer方案：同样受限于路由初始化顺序，且该组件设计目的是修改路由值字典而非直接修改Request.Path，即便修改了路径也无法被已初始化的路由系统识别。

优化建议 #

增加逻辑判断，避免处理根路径或单段路径的情况：

app.Use(async (context, next) => {
    var requestPath = context.Request.Path.Value;
    var lastSlashIndex = requestPath.LastIndexOf('/');
    
    // 仅当路径包含多个有效段时才修改（排除根路径和末尾斜杠的情况）
    if (lastSlashIndex > 0 && lastSlashIndex != requestPath.Length - 1)
    {
        context.Request.Path = requestPath[lastSlashIndex..];
    }
    await next();
});

app.UseRouting();
app.MapControllers();

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