Azure App Service部署后MVC分页列表视图不显示求助

问题现象 #

将MVC Web应用通过Azure DevOps部署到Azure App Service后，视图中的<vc:pager>组件未渲染出分页列表，仅输出类型字符串Paging.Razor.PagingList1[ViewModelClassName]`，但本地调试完全正常。

排查与解决步骤 #

1. 确认视图组件的引用与注册 #

• 检查_ViewImports.cshtml，确保添加了视图组件所在程序集的TagHelper引用（替换为你的类库名称）：

  @addTagHelper *, Paging.Razor
  

• 对于.NET Core项目，在Startup.cs的ConfigureServices中确保注册了视图组件服务：

  services.AddControllersWithViews().AddViewComponentsAsServices();
  

2. 检查独立类库的部署完整性 #

• 通过Azure门户的高级工具(Kudu) → Debug console → Site/wwwroot/bin，查看是否存在Paging.Razor.dll文件：
  • 若缺失，检查Azure DevOps构建任务：确保构建时包含该独立类库项目，且设置了复制本地依赖项为true，保证类库dll被复制到MVC项目输出目录。
  • 若使用NuGet引用该类库，确认NuGet包在部署时被正确还原并包含在输出包中。

3. 验证视图组件参数传递 #

• 检查PagerViewComponent的InvokeAsync方法参数名称与视图中paging-list的映射是否一致（Razor组件参数采用驼峰命名匹配）：

  public class PagerViewComponent : ViewComponent
  {
      public async Task<IViewComponentResult> InvokeAsync(PagingList<object> pagingList)
      {
          // 业务逻辑
          return View(pagingList);
      }
  }
  

• 临时修改组件方法，将参数改为object类型，输出参数的GetType()和内容，确认是否接收到了正确的PagingList<T>实例，而非类型字符串。

4. 排除环境配置差异 #

• 检查Azure App Service的ASPNETCORE_ENVIRONMENT配置，是否与本地调试环境存在差异导致视图编译或组件加载异常。
• 尝试禁用生产环境的视图编译优化，在MVC项目的.csproj中添加以下配置后重新部署：

  <PropertyGroup>
      <MvcRazorCompileOnPublish>false</MvcRazorCompileOnPublish>
  </PropertyGroup>
  

5. 确认类型识别有效性 #

• 确保PagingList<T>类的命名空间在MVC项目中被正确引用，或尝试将独立类库的代码临时复制到MVC项目中测试，排除跨程序集类型识别问题。

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