ASP.NET Core 5.0中Blazor路由逻辑变更详解

ASP.NET Core 5.0中Blazor路由逻辑变更详解

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

前言

在ASP.NET Core 5.0.1版本中，Blazor框架对路由匹配逻辑进行了重要修正。这一变更主要影响了包含通配符路由和可选参数路由的应用程序。作为开发者，理解这一变更对于维护和升级现有Blazor应用至关重要。

路由优先级问题背景

在之前的版本中，Blazor的路由系统存在一个逻辑缺陷，导致路由匹配时优先级判断不正确。具体表现为：

1. 低优先级的路由会被优先匹配
2. 通配符路由({*slug})会优先于更具体的路由(如/customer/{id})被匹配

这种行为与ASP.NET Core其他部分的路由逻辑不一致，属于实现上的错误。

变更详情

旧行为(5.0.1之前)

在旧版本中，路由匹配存在以下特点：

• 路由长度是主要判断标准
• 通配符路由可能优先于更具体的路由被匹配
• 与ASP.NET Core其他部分的路由行为不一致

新行为(5.0.1及以后)

修正后的路由逻辑：

1. 分段优先原则：首先根据每个路由段(segment)的优先级进行判断
2. 长度作为次要标准：只有在优先级相同的情况下，才会考虑路由长度
3. 与ASP.NET Core统一：现在Blazor的路由行为与其他ASP.NET Core应用保持一致

实际影响示例

假设有以下两个路由定义：

1. /customer/{id}
2. {*slug}

在旧版本中，当访问/customer/123时，可能会错误地匹配到{*slug}路由。而在新版本中，会正确匹配到更具体的/customer/{id}路由。

迁移建议

对于从旧版本升级到5.x的项目，建议采取以下步骤：

1. 在应用的Router组件上添加PreferExactMatches属性
2. 将该属性值设为true

示例代码：

<Router AppAssembly="@typeof(Program).Assembly" PreferExactMatches="true">
    <!-- 其他配置 -->
</Router>

设置PreferExactMatches="true"后，路由系统将：

• 优先匹配精确路由
• 其次考虑通配符路由
• 确保与ASP.NET Core其他部分行为一致

变更原因

这一变更是为了：

1. 修正原有的实现错误
2. 统一Blazor与ASP.NET Core的路由行为
3. 提供更可预测的路由匹配结果

注意事项

1. 这一变更主要影响包含通配符或可选参数的路由
2. 对于简单的路由配置可能不会产生明显影响
3. 建议在升级后进行全面测试，特别是涉及复杂路由的场景

总结

ASP.NET Core 5.0.1对Blazor路由逻辑的修正是一个重要的改进，它使Blazor的路由行为与ASP.NET Core其他部分保持一致。开发者应了解这一变更，并在升级时采取适当的迁移措施，特别是对于使用复杂路由配置的应用。通过设置PreferExactMatches属性，可以确保应用在新版本中保持预期的路由行为。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs