IIS10环境下跨多个Web应用共用母版页引用报错求助

现有环境与需求 #

• 开发环境：Windows 10 Pro + Visual Studio 2013
• 生产环境：Windows Server 2016 + IIS 10
• 核心需求：内网多个Web应用共用同一母版页，统一站点风格，母版页仅包含公司Logo与公共导航链接

现有部署结构 #

物理路径结构 #

C:\inetpub\wwwroot\MainApp 
C:\inetpub\wwwroot\MainApp\App1
C:\inetpub\wwwroot\MainApp\App2
C:\inetpub\wwwroot\MainApp\AppN

IIS站点结构 #

HostServer
└── Sites
    └── Default Web Site
        └── MainApp
            ├── App1
            ├── App2
            └── MasterPage

现有代码实现 #

母版页（Site.Master）代码 #

<%@ Master Language="VB"  %>

<!DOCTYPE html>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>Untitled Page</title>
    <asp:ContentPlaceHolder ID="head" runat="server">
    </asp:ContentPlaceHolder>
   
</head>
<body>
    <form id="form1" runat="server">
        <div id="topContent">
              <img src="companylogo.jpg" alt="" />
            <ul>
                <li><a href="#">Home</a></li>
                <li><a href="#">News</a></li>
                <li><a href="#">Contact</a></li>
                <li><a href="#">About</a></li>
            </ul>
        </div>

        <div id="mainContent">
            <asp:ContentPlaceHolder ID="MainContent" runat="server">
            </asp:ContentPlaceHolder>
        </div>
    </form>
</body>
</html>

测试页（WebForm1.aspx）代码 #

<%@ Page Title="" Language="vb" AutoEventWireup="false" MasterPageFile="~/../MasterPage/Site.Master" CodeBehind="WebForm1.aspx.vb" Inherits="NewTestWithMasterPage.WebForm1" %>

<asp:Content ID="Content1" ContentPlaceHolderID="MainContent" runat="server">
</asp:Content>

报错信息 #

虚拟路径'/MainApp/MasterPage/Site.Master'映射到另一个应用，该操作不被允许。

问题原因 #

1. ASP.NET默认禁止跨应用程序边界引用母版页，即使通过虚拟目录映射，只要母版页所在路径属于另一个应用程序上下文，就会触发该报错
2. 你之前仅在MainApp层级添加了MasterPage虚拟目录，测试应用NewTestWithMasterPage是独立的IIS应用，拥有独立的应用程序域，无法识别父级的虚拟目录
3. 母版页引用路径写法~/../MasterPage/Site.Master会被ASP.NET解析为当前应用根目录的上级路径，跨应用后该路径不被规则允许

解决方案 #

方案1：将母版页编译为独立类库（推荐，维护成本低） #

1. 新建单独的类库项目，将母版页、关联的样式、图片、JS等公共资源都放入该项目
2. 将母版页的「生成操作」属性设置为「嵌入的资源」，编译类库得到dll文件
3. 所有子应用项目引用该dll，同时在每个子应用的web.config中配置如下节点：

<system.web>
  <pages>
    <controls>
      <add assembly="你的母版页类库名称" namespace="类库命名空间" tagPrefix="custom" />
    </controls>
  </pages>
</system.web>

4. 子应用页面引用母版页时直接使用类库中的资源，写法如下：

<%@ Page MasterPageFile="~/你的类库命名空间.Site.Master" ... %>

5. 公共静态资源（Logo、CSS等）可以统一放在站点根目录的公共文件夹，所有应用使用绝对路径引用即可

方案2：调整IIS结构+预编译母版页（适合小规模站点） #

1. 不要将MasterPage目录设置为独立应用，改为在每个子应用根目录下都添加指向母版页物理路径的虚拟目录，注意是子应用内部的虚拟目录，不是父级站点的
2. 母版页预编译后，将编译后的dll放到每个子应用的bin目录下
3. 页面引用母版页的路径改为当前应用内的虚拟目录路径：~/MasterPage/Site.Master
4. 该方案更新母版页后需要同步所有子应用的bin目录dll，维护成本较高

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