Umbraco网站首页访问报错，Default.aspx及子页面可正常访问

这问题我之前帮好几个开发者排查过，核心大概率是默认文档配置或者Umbraco路由规则出了问题，咱们一步步来定位解决：

• 优先检查IIS默认文档顺序
  系统尝试查找index.html.var，说明当前默认文档列表里，default.aspx的优先级太低甚至没被添加。操作步骤：

  1. 打开IIS管理器，找到你的Umbraco网站
  2. 点击「默认文档」功能
  3. 如果default.aspx不在列表里，点击「添加」输入它；如果存在，把它拖动到列表最顶部
  4. 保存配置后刷新网站测试
     注意：有些服务器的全局默认文档配置会覆盖站点级设置，必要时也要检查全局的默认文档列表。

• 验证Umbraco的URL重写规则
  Umbraco依赖自定义重写规则来处理路由，要是规则缺失或优先级不对，首页请求就不会被导向default.aspx。打开网站根目录的web.config，检查<rewrite/rules>节点下是否有类似这样的核心规则：

  <rule name="Umbraco Main Rewrite" stopProcessing="true">
    <match url="^(?!.*(?:css|js|images|fonts|media)).*$" />
    <conditions logicalGrouping="MatchAll">
      <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
      <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
    </conditions>
    <action type="Rewrite" url="default.aspx" />
  </rule>
  

  如果这条规则缺失，就添加上；如果存在，检查是否有其他重写规则排在它前面，导致首页请求被提前拦截。

• 确认Umbraco后台首页节点配置
  登录Umbraco后台（访问/umbraco），找到首页内容节点：

  1. 检查它是否关联了正确的模板，有没有被意外取消模板绑定
  2. 查看节点的「URL」属性，确保是空值或者设置为/，避免路由冲突

• 排查服务器MIME类型与错误配置
  系统找index.html.var可能是服务器上存在不必要的MIME映射干扰。打开IIS的「MIME类型」功能，检查是否有.var相关的配置，如有可以暂时删除测试。
  另外，你可以临时关闭自定义错误获取更详细的报错：在web.config里修改<customErrors mode="Off" />（生产环境测试完记得改回RemoteOnly），能帮你定位更具体的问题。

• 清理Umbraco缓存
  缓存损坏也可能导致路由异常，试试这些操作：

  1. 删除网站App_Data/TEMP文件夹下的所有文件
  2. 在IIS里重启网站的应用池
  3. 登录Umbraco后台，右键点击内容根节点选择「刷新」

按这个顺序排查，基本能解决首页404的问题。

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