Razor Web应用部署新代码后首次渲染极慢，请求技术排查建议

DevOps 小满

2026-5-14

结论：这绝对是Razor视图动态编译导致的性能问题

从你给出的堆栈信息——尤其是BuildManager.CompileWebFile这个核心方法——可以100%确定，问题出在首次部署后的动态视图编译上。我之前处理过好几个类似的场景，你的症状和堆栈完全吻合。

为什么会出现这个问题？

Razor视图默认在首次被访问时才会动态编译成.NET程序集，如果你的网站有大量视图，这个过程会直接拖垮首次访问性能：

编译单个视图本身就需要解析语法、生成IL代码，大量视图叠加起来就是分钟级的等待
编译过程中BuildManager会对视图文件加锁（就是你检测到的应用锁），防止重复编译，这会导致后续所有请求（包括主页面请求）被阻塞，直到前面的编译任务完成
堆栈里的ViewResultBase.ExecuteResult、ViewResult.FindView、RazorView.RenderView都是在触发视图查找和渲染的流程中，最终走到了编译环节，被锁卡住

解决建议（按优先级排序）

1. 启用视图预编译（最推荐）

部署前就把所有视图编译成程序集，彻底避免部署后动态编译的开销。

对于.NET Framework项目：在项目属性的“生成”选项中勾选“预编译视图”，或者在web.config里添加对应配置
对于.NET Core/.NET 5+项目：修改项目文件（.csproj）添加以下配置：

<PropertyGroup>
  <!-- 发布时预编译视图 -->
  <MvcRazorCompileOnPublish>true</MvcRazorCompileOnPublish>
  <!-- 构建时就编译视图，提前发现语法错误 -->
  <RazorCompileOnBuild>true</RazorCompileOnBuild>
  <!-- 如果使用裁剪发布，必须禁用，否则会破坏预编译视图 -->
  <PublishTrimmed>false</PublishTrimmed>
</PropertyGroup>

预编译后，部署包会包含编译好的视图程序集，首次访问直接加载，不会有任何编译等待。

2. 实现部署后预热机制

如果因为某些原因无法预编译，可以在部署完成后主动触发所有视图的编译，而不是等用户访问。

写一个后台任务或者启动时的初始化逻辑，遍历网站所有视图文件路径，通过ICompositeViewEngine查找视图并触发编译：

// .NET Core 示例代码
using Microsoft.AspNetCore.Mvc.ViewEngines;
using Microsoft.Extensions.Logging;

public class ViewPreWarmer
{
    private readonly ICompositeViewEngine _viewEngine;
    private readonly ILogger<ViewPreWarmer> _logger;

    public ViewPreWarmer(ICompositeViewEngine viewEngine, ILogger<ViewPreWarmer> logger)
    {
        _viewEngine = viewEngine;
        _logger = logger;
    }

    public async Task WarmUpAsync()
    {
        // 替换成你的视图路径列表，可以从配置读取或者遍历Views目录生成
        var viewPaths = new List<string> { "/Views/Home/Index.cshtml", "/Views/Shared/_Layout.cshtml" };
        
        foreach (var path in viewPaths)
        {
            try
            {
                var viewResult = _viewEngine.FindView(null, path, isMainPage: false);
                if (viewResult.Success)
                {
                    _logger.LogInformation("成功预热视图: {Path}", path);
                }
            }
            catch (Exception ex)
            {
                _logger.LogError(ex, "预热视图失败: {Path}", path);
            }
            await Task.Delay(100); // 避免并发编译导致锁竞争加剧
        }
    }
}

然后在启动时调用这个服务，或者通过部署脚本发起请求触发预热。

3. 优化动态编译的并发设置

如果必须保留动态编译，可以调整编译的并发数，减少锁竞争：

.NET Framework：在web.config的system.web/compilation节点添加maxConcurrentCompilations属性：

<system.web>
  <compilation debug="false" maxConcurrentCompilations="4" />
</system.web>

.NET Core：在appsettings.json中添加配置：

{
  "Mvc": {
    "Razor": {
      "MaxConcurrentCompilations": 4
    }
  }
}

这个设置限制同时编译的视图数量，避免大量锁等待，但治标不治本，还是预编译更彻底。

4. 拆分视图到多个类库

如果网站视图数量极多，可以按业务模块拆分视图到不同的Razor类库，每个类库单独预编译，这样部署时可以分散编译压力，也方便后续维护。

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