ASP.NET Core MVC迁移时布局页Section未渲染异常求助

问题分析 #

从异常信息看，存在两个核心问题：

1. 布局页不匹配：你指定的布局是UserLayout.cshtml，但异常提示AgentLayout.cshtml未渲染HomeTab区块，说明实际加载的布局并非预期的UserLayout，大概率是全局默认布局配置覆盖了视图的局部设置。
2. Section机制变更：ASP.NET Core MVC不支持布局页为自身定义的RenderSection提供@section实现——老版本ASP.NET MVC允许这种写法，但Core中section是子视图向布局页传递内容的机制，布局页不能自行填充自己定义的section。

解决方案 #

1. 修正布局页引用 #

• 检查Views目录下的_ViewStart.cshtml，确认是否存在全局默认布局设置：

  @{
      Layout = "~/Views/Shared/AgentLayout.cshtml";
  }
  

  如果有，要么将默认布局改为UserLayout.cshtml，要么在User.cshtml中确保局部布局设置优先级（将布局代码放在视图最顶部，避免被其他逻辑覆盖）：

  @{
      Layout = "~/Views/Shared/UserLayout.cshtml";
      // 其他视图代码
  }
  

• 重启项目并清除浏览器缓存，确保布局设置生效。

2. 调整Section实现逻辑 #

如果确认布局页确实是UserLayout.cshtml，则需要修改section的实现方式：

• 场景1：HomeTab为布局页固定内容
  直接移除@section HomeTab {}，将内容写在@RenderSection的位置：

  <!-- 原@RenderSection("HomeTab", true)位置 -->
  <div class="k-tab-content">
      <!-- 写入原HomeTab section中的固定内容 -->
  </div>
  

• 场景2：允许子视图覆盖HomeTab内容
  将RenderSection的required设为false，并提供默认内容：

  @RenderSection("HomeTab", required: false) ?? @<div>默认的HomeTab内容</div>
  

  此时子视图User.cshtml可选择是否定义@section HomeTab {}来覆盖默认内容。
• 场景3：布局页和子视图都需要展示内容
  放弃section机制，改用局部视图或直接拼接内容：

  <!-- 布局页中 -->
  <div class="k-tab-content">
      <!-- 布局页固定内容 -->
      <partial name="HomeTabDefaultContent" />
      <!-- 子视图可选内容 -->
      @await RenderPartialAsync("HomeTabUserContent")
  </div>
  

额外排查点 #

• 检查User.cshtml是否继承了自定义视图基类，基类中是否设置了Layout属性导致视图的布局设置被覆盖。
• 确认文件路径大小写：ASP.NET Core在Linux等系统中区分文件路径大小写，检查UserLayout.cshtml的路径拼写是否完全匹配。

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