部署后View Component不渲染，但本地运行正常求助

问题详情 #

近期切换至GitHub Actions部署后，出现View Component渲染异常：本地运行、Visual Studio发布均正常，但通过GitHub部署后组件无法正常渲染。

异常核心现象：部署后查看页面源码时，组件已被正确渲染为完整HTML；但在浏览器开发者工具的Elements面板中，仍显示原<vc:header>标签，未被替换。此外代码及相关依赖未做变更，JS和CSS加载正常，此前GitHub Actions部署曾正常运行。

相关代码 #

_Layout.cshtml中的组件调用 #

<vc:header is-error-page="false"></vc:header>

_ViewImports.cshtml配置 #

@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers
@addTagHelper *, Project.Common.Web
@addTagHelper *, Project.Admin.Web

HeaderViewComponent实现 #

public class HeaderViewComponent : ViewComponent
{
    private readonly IMediator _mediator;

    public HeaderViewComponent(IMediator mediator)
    {
        _mediator = mediator;
    }

    public async Task<IViewComponentResult> InvokeAsync(bool isErrorPage)
    {
        var model = await _mediator.Send(new Header.Query(UserClaimsPrincipal, HttpContext.Session.GetString(SessionKeys.HeaderRole)!, isErrorPage), HttpContext.RequestAborted);

        return View(model);
    }
}

解决方案 #

1. 确认GitHub Actions的发布配置 #

检查部署脚本是否使用Release模式发布，且启用了视图编译：

• 确保发布命令为：

  dotnet publish -c Release -o ./publish
  

• 检查项目.csproj文件，确认视图编译配置未被禁用：

  <PropertyGroup>
    <MvcRazorCompileOnPublish>true</MvcRazorCompileOnPublish>
    <MvcRazorRuntimeCompilation>false</MvcRazorRuntimeCompilation>
  </PropertyGroup>
  

如果启用了运行时编译，部署环境可能因缺少编译依赖导致标签助手解析异常。

2. 清理部署缓存 #

GitHub Actions的缓存可能残留旧视图文件，导致新部署内容未生效：

• 在部署步骤中添加清理publish目录的命令；
• 若使用actions/cache动作，更新缓存键（如添加项目文件哈希），避免命中旧缓存。

3. 排查服务器端运行时异常 #

虽然页面源码显示渲染正常，但可能存在部分请求异常导致浏览器显示异常：

• 在InvokeAsync方法中添加日志，记录方法调用情况、参数值及是否有异常抛出；
• 验证部署环境中Session是否正常启用，UserClaimsPrincipal能否正确获取用户信息；
• 检查HttpContext.Session.GetString(SessionKeys.HeaderRole)是否可能返回null，导致空引用异常（代码中使用了!断言，需确认部署环境中该Session值一定存在）。

4. 清除浏览器缓存 #

用户浏览器缓存的旧页面资源可能导致显示异常：

• 强制刷新页面（Ctrl+F5）；
• 部署时为静态资源添加版本哈希，避免浏览器缓存旧内容。

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