ASP.NET Core 5 MVC引入嵌套布局后父布局无法访问已注册服务的原因？

异常原因 #

1. Razor 页面默认采用从内到外的渲染顺序：最先渲染最底层的普通内容页，再向上渲染父级子布局，最后才渲染最顶层的主布局。如果在子布局或内容页中存在提前终结请求的代码（比如Response.CompleteAsync()、HttpContext.Abort()），就会导致渲染顶层主布局时，原始请求的HttpContext已经被释放，框架会自动 fallback 到无实际请求信息的DefaultHttpContext，对应布局的Context属性也会变成 null。
2. 子布局错误添加了@page指令：@page是用于标记可独立路由的 Razor 页面的指令，布局页添加该指令后会生成独立的请求上下文，无法继承内容页的上下文信息，导致上层主布局无法获取到正确的服务作用域。
3. 使用自定义 Razor 布局基类时，没有正确关联Context属性：自定义基类中如果手动重写了Context属性，没有绑定到当前ViewContext.HttpContext，就会出现上下文丢失的问题。

解决方案 #

• 排查所有内容页、子布局的代码，移除提前终结请求的相关调用，这类操作统一放到页面渲染完成之后的中间件或者过滤器中执行。
• 所有布局页（包括主布局、子布局）都删除@page指令，仅保留可独立访问的内容页的@page指令。
• 如果使用自定义布局基类，确保Context属性正确关联视图上下文：

public class CustomLayoutBase : RazorPage<dynamic>
{
    // 不要用私有字段存储Context，每次都从ViewContext获取
    public HttpContext Context => ViewContext?.HttpContext;
}

• 若你的IFooService依赖HttpContext，确保在服务注册时添加了IHttpContextAccessor的注册，且服务使用 Scoped 生命周期：

// Program.cs 中添加
builder.Services.AddHttpContextAccessor();
builder.Services.AddScoped<IFooService, FooService>();

• 排查子布局、内容页中调用分部视图、ViewComponent 的代码，不要主动传入新构造的ViewContext实例，默认继承当前上下文即可。

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