预编译ASP.NET Web应用部署客户端提示aspx未预编译错误排查问询

以下是已确认页面完成预编译前提下，该报错的常见触发原因及排查方向：

• 文件传输/部署完整性问题
  updatable=false模式下，每个aspx页面对应的核心编译产物为：站点根目录的aspx标记文件、bin目录下的[页面名].aspx.compiled映射文件、以及对应的程序集dll，三者缺一不可。
  排查时优先对比本地构建包与客户端部署包的文件清单与哈希值，优先使用压缩包整体传输避免散文件拷贝遗漏，同时检查客户端杀毒软件/安全策略是否误删了bin目录下的.compiled文件或dll文件。
• IIS应用目录/虚拟路径配置不匹配
  预编译过程会绑定应用的虚拟路径，若本地是作为父应用下的子应用（虚拟路径如/SubApp）构建，客户端部署时虚拟路径配置与本地不一致、或是直接部署为根站点，都会导致预编译的路径映射失效，触发报错。需确保客户端的父应用、子应用的虚拟目录层级、别名与本地测试环境完全一致。
• 应用程序池配置不兼容
  检查客户端站点对应的应用程序池配置：
  1. .NET Framework版本是否与本地构建使用的版本完全一致，高版本编译的产物无法在低版本运行环境加载
  2. 应用程序池的“启用32位应用程序”配置是否与本地一致，若本地是64位编译，客户端开启32位模式会无法识别编译产物
• 文件权限配置错误
  确认IIS应用程序池运行身份对站点根目录、bin目录有读取&执行权限，若身份无权限读取.compiled文件或程序集dll，IIS会判定页面未预编译，触发报错。
• ASP.NET临时缓存冲突
  客户端服务器上可能残留了旧版本的站点编译缓存，与新部署的预编译产物冲突。可按以下步骤清理：
  1. 停止站点对应的应用程序池
  2. 进入.NET Framework对应版本的临时缓存目录，默认路径为C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files\（32位环境替换为Framework目录）
  3. 删除对应站点的缓存文件夹
  4. 重启应用程序池
• 父应用配置继承冲突
  检查父应用的web.config是否存在异常的<compilation>节点配置，覆盖了子应用的预编译设置；同时确认父应用的PreCompiledapp.config配置与本地测试环境完全一致，无额外修改。

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