You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Umbraco 10部署后首页报错:未找到Home模板文件求助

问题描述

基于Umbraco Visual Studio ASP.NET Core(.NET6)开发的Umbraco应用,使用Umbraco 10.4和uSync 10.3.3 NuGet包。站点仅包含名为“Home”的文档类型及对应首页,已配置子域名主机名,本地运行正常。部署至Windows Server 2022(IIS 10、MS SQL Server Express 2019)的VPS后,Umbraco后台运行正常,但访问首页显示“页面未找到”,应用日志出现警告:

2023-03-11T13:55:39.2339886+00:00 [WRN] (Umbraco.Cms.Web.Common.Controllers.RenderController)
No physical template file was found for template "Home"

已确认Home模板已正确部署,应用程序池身份对站点目录拥有完全控制权限,求问题原因。

可能的原因及排查方向
  • 模板文件路径/命名不匹配:Umbraco对模板文件名和路径区分大小写,检查部署后的模板是否存在大小写不一致(比如本地是Home.cshtml,部署后变为home.cshtml);同时确认模板是否在默认路径Views/{DocumentTypeAlias}.cshtml或Views/Shared/{DocumentTypeAlias}.cshtml下,若自定义了视图位置,需验证配置是否生效。
  • uSync同步导致模板关联丢失:部署后uSync可能未正确同步文档类型与模板的绑定关系。进入Umbraco后台,检查Home文档类型的「模板」设置,确认已选中对应的Home模板;也可手动触发uSync同步,验证关联是否恢复。
  • 视图编译异常:ASP.NET Core部署时默认预编译视图,若模板文件在编译中被排除或编译失败,会导致模板无法被识别。检查发布配置文件(pubxml)中是否设置<MvcBuildViews>true</MvcBuildViews>,若开启视图编译需确保过程无错误;也可尝试关闭预编译(设为false)后重新发布测试。
  • 主机名与节点路由不匹配:已配置子域名主机名,需确认后台Home节点的「主机名」设置与访问的子域名完全一致(包括是否带www、端口等)。Umbraco会根据主机名匹配对应节点,匹配失败会导致路由异常,进而触发模板缺失警告。
  • 应用程序池配置错误:尽管权限已设置完全控制,仍需确认应用程序池是否启用了32位应用程序(若项目为64位需禁用);同时检查.NET CLR版本是否设置为「无托管代码」(ASP.NET Core项目要求),错误的CLR版本会导致视图加载异常。

内容的提问来源于stack exchange,提问作者Paul Taylor

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.28 22:20:13