Blazor Server中CircuitHandler.OnConnectionDownAsync导航触发问题咨询

我的Blazor Server代码实现了CircuitHandler类的OnConnectionDownAsync事件处理程序，但调用NavigationManager.NavigateTo()时该方法会被触发。这种行为会导致导航时关闭现有连接并新建连接，产生额外开销。请问该行为是否有官方文档说明，或是我的代码存在问题？

代码示例 #

public class TrackingCircuitHandler : CircuitHandler
{
    private HashSet<Circuit> circuits = new();

    public override Task OnConnectionUpAsync(Circuit circuit,
        CancellationToken cancellationToken)
    {
        TimeSpan time = DateTime.Now.TimeOfDay;
        circuits.Add(circuit);

        return Task.CompletedTask;
    }

    // 导航时会调用此方法，导致新建连接****************
    public override Task OnConnectionDownAsync(Circuit circuit,
        CancellationToken cancellationToken)
    {
        TimeSpan time = DateTime.Now.TimeOfDay;
        circuits.Remove(circuit);

        return Task.CompletedTask;
    }

    public int ConnectedCircuits => circuits.Count;
}

问题解答 #

这是Blazor Server的正常原生行为，并非你的代码存在问题。

Blazor Server中，Circuit（电路）与浏览器标签页的会话绑定，当发生以下导航场景时，会触发现有Circuit断开，后续重新建立新连接：

1. 导航到非交互式内容页面：比如静态HTML、Razor Pages或MVC视图，这类页面不依赖Blazor的SignalR连接，浏览器会直接刷新页面并断开原有Circuit。
2. 调用NavigationManager.NavigateTo()时传入forceLoad: true：该参数会强制浏览器进行完整页面刷新，自然会断开当前SignalR连接。
3. 跨交互式渲染模式导航：比如从使用InteractiveServer渲染的页面导航到使用InteractiveWebAssembly的页面，也会触发Circuit重建。

官方文档明确说明，Circuit的生命周期与浏览器会话绑定，页面刷新、离开Blazor应用范围的导航都会导致Circuit终止。你的TrackingCircuitHandler只是正确捕获了这个既定行为，代码逻辑没有错误。

优化建议 #

如果想减少不必要的连接重建开销，可参考以下做法：

• 确保所有内部导航都在Blazor交互式路由体系内进行，避免跳转到非Blazor页面。
• 除非确有必要，否则不要在NavigateTo()中使用forceLoad: true参数。
• 统一应用的交互式渲染模式，避免跨模式导航触发Circuit重建。

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