Blazor Server中MainLayout作为CascadingParameter始终为null问题排查

• 检查页面是否使用目标布局：确认SignIn.razor没有显式指定其他布局（比如@layout EmptyLayout）。Blazor默认使用MainLayout，但一旦指定其他布局，页面就不会被MainLayout的<CascadingValue>包裹，自然拿不到对应级联值。

• 确认CascadingValue的作用范围：MainLayout.razor中必须将@Body放在<CascadingValue>内部，否则页面组件无法接收到级联值。正确写法示例：

<CascadingValue Value="this">
    @* 布局其他内容 *@
    @Body
</CascadingValue>

• 验证生命周期时机：OnInitialized是组件初始化的早期阶段，级联参数可能尚未完成绑定。尝试在OnInitializedAsync或OnAfterRenderAsync(bool firstRender)中访问（仅在firstRender=true时执行逻辑），看是否能获取到Layout实例。

• 检查CascadingValue的赋值正确性：确保MainLayout里的<CascadingValue Value="this">没有拼写错误，且this指向当前MainLayout实例（没有被重赋值或引用丢失）。

• 排查嵌套布局的传递问题：如果SignIn页面使用的是MainLayout的子布局，子布局需要显式传递该级联参数。比如子布局中需先接收父布局的级联值，再重新包裹@Body传递下去：

@inherits LayoutComponentBase
[CascadingParameter] public MainLayout ParentLayout { get; set; }

<CascadingValue Value="ParentLayout">
    @Body
</CascadingValue>

• 调试布局渲染顺序：在MainLayout的生命周期方法（如OnAfterRender）中添加日志，确认SignIn页面初始化时，MainLayout是否已完成渲染并传递了级联值。若MainLayout存在异步加载逻辑，可能导致级联值延迟传递。

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