.NET 9 Blazor项目在_Imports.razor中声明布局致加载失败及内存暴涨

核心原因 #

你遇到的是布局组件循环引用引发的无限递归渲染：

• 在Pages/Admin文件夹的_Imports.razor中设置@layout AdminLayout后，该规则会作用于文件夹内所有组件，包括AdminLayout.razor本身。
• 布局组件渲染时会尝试应用自身作为布局，触发无限递归，导致Blazor持续重复渲染组件，最终耗尽CPU和内存，出现无响应、崩溃的情况。
• 而将@layout直接写在Home.razor顶部时，仅对该页面生效，不会影响布局组件本身，因此不会触发循环。

解决方法 #

方法1：将布局组件移出目标文件夹（推荐）

把AdminLayout.razor移动到项目根目录的Shared文件夹（或其他不在Pages/Admin及其子目录下的位置），这样Pages/Admin/_Imports.razor的布局规则就不会作用到布局组件本身，彻底避免循环引用。

方法2：在布局组件中显式打破循环

如果需要保留AdminLayout.razor在Pages/Admin文件夹内，在AdminLayout.razor顶部添加以下代码，强制取消自身的布局规则：

@layout null

或者指定一个基础布局（比如项目默认的MainLayout）：

@layout MainLayout

这样布局组件渲染时会使用指定的基础布局，不会递归应用自身。

方法3：保持页面单独指定布局（原可行方案）

继续使用在每个Admin页面顶部添加@layout AdminLayout的方式，虽然不够便捷，但能直接避免循环引用问题。

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