Blazor Server应用子文件夹布局引发无限循环问题求助

核心问题判断 #

这种浏览器持续卡顿的现象，几乎可以确定是布局组件的循环引用导致的——你的TestTemplate.razor（文件夹级布局）大概率出现了直接/间接引用自身，或嵌套了使用该布局的组件，触发了无限渲染循环。

逐项排查步骤 #

• 检查Test/_Imports.razor：确认仅添加了@layout TestTemplate，没有多余的冲突指令。
• 检查TestTemplate.razor代码：
  • 绝对不能在布局组件内引用Test/Index.razor，也不能给布局本身指定@layout TestTemplate（即自己用自己当布局）。
  • 必须保留@Body指令，这是渲染页面内容的入口，缺失可能引发异常或循环。
• 检查Test/Index.razor：不要手动添加@layout指令，避免覆盖文件夹级布局设置引发冲突。
• 验证App.razor路由：确保RouteView的DefaultLayout为MainLayout，文件夹级布局会自动覆盖默认值，路由配置错误也可能触发异常。

正确代码示例 #

Test/_Imports.razor #

@layout TestTemplate
@using System.Net.Http
@using Microsoft.AspNetCore.Components.Forms
@using Microsoft.AspNetCore.Components.Routing
@using Microsoft.AspNetCore.Components.Web
@using Microsoft.JSInterop

TestTemplate.razor #

@inherits LayoutComponentBase

<div class="test-container">
    <h3>Test 文件夹专属布局</h3>
    @* 必须保留@Body，用于承载子页面内容 *@
    @Body
</div>

<style>
    .test-container {
        padding: 20px;
        background-color: #f0f0f0;
    }
</style>

Test/Index.razor #

@page "/test"

<h1>Test 页面</h1>
<p>这是Test文件夹下的测试页面</p>

额外验证操作 #

删除项目根目录下的bin和obj文件夹清理缓存，重启Visual Studio和浏览器后重新编译运行，排除缓存残留引发的异常。

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