Blazor.WASM中如何从路由获取全局可用的公共路由值

不需要自定义路由器或重写路由解析逻辑，直接使用Blazor内置能力即可实现全局路由公共段（文化标识、租户ID等）提取和全局共享，落地步骤如下：

核心实现（推荐方案） #

直接修改项目默认的Routes.razor文件（即存放内置Router组件的根路由文件），在外层包裹级联值组件，结合NavigationManager监听地址变化提取公共段，全程不改动内置路由逻辑。

完整代码示例：

@inject NavigationManager NavManager
@implements IDisposable

<!-- 全局级联提取到的公共路由值 -->
<CascadingValue Value="@CurrentGlobalRouteValue" Name="GlobalRouteSegment">
    <Router AppAssembly="@typeof(App).Assembly">
        <Found Context="routeData">
            <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
            <FocusOnNavigate RouteData="@routeData" Selector="h1" />
        </Found>
        <NotFound>
            <PageTitle>Not found</PageTitle>
            <LayoutView Layout="@typeof(MainLayout)">
                <p role="alert">地址不存在</p>
            </LayoutView>
        </NotFound>
    </Router>
</CascadingValue>

@code {
    private string? CurrentGlobalRouteValue { get; set; }
    // 按你的实际路由基地址配置，示例对应/base/开头的路由
    private const string RouteBasePrefix = "base/";

    protected override void OnInitialized()
    {
        NavManager.LocationChanged += OnLocationChanged;
        // 首次加载就提取值
        ExtractPublicSegment();
    }

    private void OnLocationChanged(object? sender, LocationChangedEventArgs e)
    {
        ExtractPublicSegment();
        // 刷新组件让级联值同步到所有子组件
        StateHasChanged();
    }

    private void ExtractPublicSegment()
    {
        var relativePath = NavManager.ToBaseRelativePath(NavManager.Uri);
        // 不匹配基路径时清空值
        if (!relativePath.StartsWith(RouteBasePrefix, StringComparison.OrdinalIgnoreCase))
        {
            CurrentGlobalRouteValue = null;
            return;
        }
        // 拆分路径段，取基路径后的第一个段作为公共值
        var pathSegments = relativePath.Split('/', StringSplitOptions.RemoveEmptyEntries);
        CurrentGlobalRouteValue = pathSegments.Length >= 2 ? pathSegments[1] : null;
        
        // 这里可以直接加对应业务逻辑：
        // 比如是文化参数就直接设置当前线程UI文化、是租户ID就初始化租户上下文
    }

    public void Dispose()
    {
        NavManager.LocationChanged -= OnLocationChanged;
    }
}

全局使用方式 #

所有页面、组件不需要修改原有@page路由声明，只要添加级联参数就能直接拿到公共值：

@code {
    [CascadingParameter(Name = "GlobalRouteSegment")]
    private string? CultureOrTenantId { get; set; }
}

方案优势 #

• 零自定义路由逻辑：完全基于Blazor内置组件和导航服务实现，没有重写Router、自定义路由匹配的复杂度
• 无侵入：不需要修改现有任何页面的路由模板，不需要强制所有页面继承自定义基类
• 实时同步：路由跳转时会自动更新提取到的值，级联值会自动同步到所有下游组件
• 易扩展：需要校验公共值合法性（比如判断文化是否支持、租户是否存在）时，直接在ExtractPublicSegment方法中添加校验逻辑即可，校验不通过可直接跳转兜底页面。

可选增强 #

如果不想在每个组件里重复声明级联参数，可以加一个仅包含参数接收逻辑的轻量页面基类，所有需要访问公共值的页面继承该基类即可，代码量远小于自定义路由器实现。

注意：如果使用Blazor Web App的Auto/WebAssembly交互式渲染模式，需要把上述逻辑同时放在服务端和客户端的Routes.razor中，保证预渲染和客户端交互阶段的取值一致。

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