ASP.NET Core 7 MVC：如何在_Layout.cshtml中访问HttpContext？

问题原因 #

在Razor视图中直接调用HttpContext会导致该变量为null，因为视图的内置上下文对象是Context而非HttpContext，这就是触发「Object reference required」错误的核心原因。

解决步骤 #

1. 控制器中正确添加对象到HttpContext.Items #

在控制器的Action方法或全局过滤器中，通过控制器的HttpContext属性将对象存入Items集合，确保逻辑在视图渲染前执行：

public class HomeController : Controller
{
    public IActionResult Index()
    {
        // 模拟获取当前用户信息，实际可从登录态（如Claims）解析
        var currentUser = new User { Id = 1, Username = "JohnDoe" };
        HttpContext.Items["CurrentUser"] = currentUser;
        return View();
    }
}

// 定义强类型用户类（可选，提升类型安全性）
public class User
{
    public int Id { get; set; }
    public string Username { get; set; }
}

2. _Layout.cshtml中正确访问对象 #

在布局视图中使用内置的Context属性访问Items集合，同时建议做类型转换避免后续类型错误：

@{
    // 将Items中的对象转换为强类型，转换失败返回null
    var currentUser = Context.Items["CurrentUser"] as User;
}

<!-- 根据用户状态显示对应菜单 -->
@if (currentUser == null)
{
    <ul class="navbar-nav">
        <li class="nav-item">
            <a class="nav-link" asp-controller="Account" asp-action="Login">登录</a>
        </li>
        <li class="nav-item">
            <a class="nav-link" asp-controller="Account" asp-action="Register">注册</a>
        </li>
    </ul>
}
else
{
    <ul class="navbar-nav">
        <li class="nav-item">
            <span class="nav-link">欢迎，@currentUser.Username</span>
        </li>
        <li class="nav-item">
            <a class="nav-link" asp-controller="Account" asp-action="Logout">退出</a>
        </li>
    </ul>
}

额外优化建议 #

• 若需在所有视图中共享用户信息，可实现IAsyncActionFilter全局过滤器，统一注入用户对象，避免在每个控制器重复编写逻辑：

  public class UserInjectFilter : IAsyncActionFilter
  {
      public async Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next)
      {
          // 从登录态解析用户信息逻辑
          var user = new User { Id = 1, Username = "JohnDoe" };
          context.HttpContext.Items["CurrentUser"] = user;
          await next();
      }
  }
  

  然后在Program.cs中注册过滤器：

  builder.Services.AddControllersWithViews(options =>
  {
      options.Filters.Add<UserInjectFilter>();
  });
  

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