调用ServerManager更新web.config报错 无法写入且提示web.config路径错误

在安装程序的IIS配置逻辑中，需要依次完成两个操作：检查并创建目标虚拟目录，再向对应虚拟目录下的web.config写入指定配置节。
该安装程序此前运行稳定，近期执行时突发异常阻断安装流程，报错信息如下：

/Core/Service/UserService 配置失败。原因：Filename: \?\ c:\website1\Core\Common\Service\userService\web.config Error: cannot write configuration file

IIS内的虚拟目录层级与物理路径映射关系实际为：

• 根站点：Default Web Site
• 一级虚拟目录/Core：对应物理路径c:\website1\Core\Common
• 子虚拟目录/Core/Service/UserService：对应独立配置的物理路径c:\website1\Core\Service\UserService

报错信息中拼接出的c:\website1\Core\Common\Service\userService路径实际不存在，属于错误解析出的路径。

运行环境与实现代码 #

• 安装程序基于.NET Framework 4.8开发，为Windows桌面应用
• IIS操作逻辑位于引用System.Web.Administration命名空间的类库中
• 安装程序运行身份为系统管理员，持有服务器全量操作权限
• 报错触发的核心代码如下：

using (ServerManager mgr = new ServerManager())
{
  // 向默认站点添加虚拟路径的相关逻辑
  mgr.CommitChanges();
}
using (ServerManager mgrpolicy = new ServerManager())
{
  Configuration config = mgrpolicy.GetWebConfiguration("Default Web Site","/Core/Service/UserService");
  ConfigurationSection hndlesection = config.GetSection("system.webserver/handlers");
  hndlesection["accessPolicy"] = "Read,Write"; // 该值根据安装时的用户输入动态生成，此处为演示硬编码
  mgrpolicy.CommitChanges(); // 异常在该行执行时触发
}

这是Microsoft.Web.Administration嵌套虚拟目录解析的经典缓存同步问题：
两个完全独立的ServerManager实例各自持有独立的IIS配置缓存，第一个实例提交虚拟目录创建操作后，第二个实例初始化时没有完整拉取最新的IIS元数据库映射，无法识别/Core/Service/UserService是独立配置物理路径的子虚拟目录，解析路径时直接以父虚拟目录/Core的物理路径为根，按URL层级朴素拼接路径，最终得到不存在的c:\website1\Core\Common\Service\userService路径，写入文件时自然触发“无法写入配置文件”的错误。
该问题在首次创建子虚拟目录的场景下触发概率极高——如果子虚拟目录是提前手动创建、安装程序仅做配置更新，第二个实例初始化时通常能从元数据库读到正确的映射关系，不会触发该bug，这也是程序此前运行正常、近期突然报错的核心原因。

二选一即可解决问题：

1. 合并ServerManager实例（推荐）：将虚拟目录创建、配置写入的逻辑放在同一个ServerManager实例的生命周期内完成，仅做一次配置提交，从根源避免跨实例的缓存不同步问题。
   修复后示例代码：

   using (ServerManager mgr = new ServerManager())
   {
     // 第一步：执行虚拟目录检查、创建逻辑
     // 第二步：在当前实例下直接读取目标虚拟目录配置
     Configuration config = mgr.GetWebConfiguration("Default Web Site","/Core/Service/UserService");
     ConfigurationSection hndlesection = config.GetSection("system.webserver/handlers");
     hndlesection["accessPolicy"] = "Read,Write";
     // 统一提交所有配置变更
     mgr.CommitChanges();
   }
   

2. 强制刷新虚拟目录缓存（适配逻辑无法合并的场景）：如果因为架构拆分必须使用独立的ServerManager实例，在第二个实例读取配置前，主动调用刷新方法强制拉取最新的虚拟目录映射，确保路径解析正确。
   关键代码片段：

   using (ServerManager mgrpolicy = new ServerManager())
   {
     // 强制刷新默认站点下的虚拟目录缓存，同步最新映射关系
     mgrpolicy.Sites["Default Web Site"].Applications["/"].VirtualDirectories.Refresh();
     Configuration config = mgrpolicy.GetWebConfiguration("Default Web Site","/Core/Service/UserService");
     ConfigurationSection hndlesection = config.GetSection("system.webserver/handlers");
     hndlesection["accessPolicy"] = "Read,Write";
     mgrpolicy.CommitChanges();
   }
   

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