从Ruby on Rails迁移到.NET Core：多路由路径冲突解决

我在把项目从Ruby on Rails迁移到.NET Core时遇到了路由匹配问题：多个控制器的URL规则无前缀区分，导致.NET Core无法正确识别应该命中哪个端点，具体场景如下：

• LocationController：接收完整路径参数，匹配http://www.website.com/asia、http://www.website.com/north-america/usa/florida这类URL，参数为域名后的全部内容（如asia、north-america/usa/florida）
• SchoolController：接收slug参数，匹配http://www.website.com/st-martin-school、http://www.website.com/rene-claudius-school这类URL，参数为域名后的全部内容（如st-martin-school、rene-claudius-school）
• PageController：接收slug参数，匹配http://www.website.com/privacy-policy、http://www.website.com/contact这类URL，参数为域名后的全部内容（如privacy-policy、contact）

由于SEO要求不能修改这些URL，而Ruby on Rails是按路由配置的从上到下顺序匹配首个符合规则的端点，但.NET Core默认路由规则无法实现这种优先级匹配。最终通过自定义路由约束解决了问题，具体实现如下：

解决方案 #

1. 创建自定义路由约束匹配有效位置路径 #

实现IRouteConstraint接口，判断请求路径是否以指定洲名开头，以此区分LocationController的路由：

public class LocationConstraint : IRouteConstraint
{
    private static readonly string[] continents = { "africa", "asia", "australia", "europe", "north-america", "south-america" };

    public bool Match(HttpContext httpContext, IRouter route, string routeKey, RouteValueDictionary values, RouteDirection routeDirection)
    {
        if (values[routeKey] is null)
        {
            return false;
        }

        string routeValue = values[routeKey].ToString();

        if (continents.Contains(routeValue) || continents.Any(c => routeValue.StartsWith(c + "/", System.StringComparison.CurrentCultureIgnoreCase)))
        {
            return true;
        }

        return false;
    }
}

2. 配置LocationController的路由 #

使用通配符**捕获完整路径，并应用自定义的location约束，确保只有符合位置规则的URL才会命中该控制器：

[HttpGet("{**path:location}")]
public async Task<IActionResult> List(string path)
{
    // 控制器逻辑
}

3. 配置PageController的静态路由 #

将PageController的路由配置为具体静态路径，这类路由优先级最高，会被优先匹配：

[HttpGet("latest")]
public async Task<IActionResult> Latest()
{
    // 控制器逻辑
}

[HttpGet("privacy-policy")]
public async Task<IActionResult> PrivacyPolicy()
{
    // 控制器逻辑
}

4. 配置SchoolController的兜底路由 #

最后配置SchoolController的路由，作为兜底匹配剩余的所有单段路径：

[HttpGet("{slug}")]
public async Task<IActionResult> Detail(string slug)
{
    // 控制器逻辑
}

路由匹配优先级说明 #

.NET Core路由的匹配优先级为：

1. 静态路径（PageController的路由）
2. 带自定义约束的通配符路由（LocationController的路由）
3. 通用单段参数路由（SchoolController的路由）

这样就实现了类似Ruby on Rails的自上而下匹配逻辑，满足所有URL的SEO要求。

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