更新IIS URL重写配置引发500内部服务器错误的排查与解决

问题背景 #

偶尔会出现500内部服务器错误，根源是IIS读取web.config文件时发现文件被其他进程占用。服务器环境为Windows Server 2019，搭载IIS 10.0.17763.1版本。我们从未直接手动修改配置文件，仅通过独立ASP.NET进程中的服务使用Microsoft.Web.Administration.ServerManager组件进行配置修改，该组件最终会调用原生的IAppHostWritableAdminManager::CommitChanges方法。

需要解决两个问题：

• 是ServerManager操作导致的文件锁定，还是服务器上其他异常进程偶尔锁定了文件？
• 如果是ServerManager导致的问题，有没有办法在不引发停机的情况下更新IIS重写规则？比如先写入不锁定现有文件的新web.config，再切换为活动配置？

用于修改重写规则的代码 #

using (ServerManager serverManager = new ServerManager())
{
    Configuration config = serverManager.GetWebConfiguration("Softdial");
    ConfigurationSection rulesSection = config.GetSection("system.webServer/rewrite/rules");
    ConfigurationElementCollection rulesCollection = rulesSection.GetCollection();
    ConfigurationElement ruleElement = rulesCollection.CreateElement("rule");
    ruleElement["name"] = "My Rule";
    ruleElement["stopProcessing"] = "true";

    ConfigurationElement matchElement = ruleElement.GetChildElement("match");
    matchElement["url"] = @"example/(.*)";

    ConfigurationElement actionElement = ruleElement.GetChildElement("action");
    actionElement["type"] = @"Rewrite";
    actionElement["url"] = "http://localhost:8999/{R:1}";
    actionElement["logRewrittenUrl"] = "true";

    rulesCollection.Add(ruleElement);

    serverManager.CommitChanges();
}

报错信息 #

服务器错误在 '/' 应用程序中。
配置错误
说明: 处理服务此请求所需的配置文件时出错。请查看下面的具体错误详细信息并适当修改配置文件。

分析器错误消息: 加载配置文件时出错: 进程无法访问文件 'C:\MyWebSite\web.config'，因为它正被另一个进程使用。

源错误:


[无相关源行]

源文件: C:\MyWebSite\web.config    行: 0


点击此处显示其他错误信息:

异常详细信息: System.IO.IOException: 进程无法访问文件 'C:\MyWebSite\web.config'，因为它正被另一个进程使用。

源错误:

执行当前 Web 请求期间生成了未经处理的异常。可使用下面的异常堆栈跟踪信息确定异常的来源和位置。

堆栈跟踪:


[IOException: 进程无法访问文件 'C:\MyWebSite\web.config'，因为它正被另一个进程使用。]
   System.IO.__Error.WinIOError(Int32 errorCode, String maybeFullPath) +935
   System.IO.FileStream.Init(String path, FileMode mode, FileAccess access, Int32 rights, Boolean useRights, FileShare share, Int32 bufferSize, FileOptions options, SECURITY_ATTRIBUTES secAttrs, String msgPath, Boolean bFromProxy, Boolean useLongPath, Boolean checkHost) +1242
   System.IO.FileStream..ctor(String path, FileMode mode, FileAccess access, FileShare share) +126
   System.Configuration.Internal.InternalConfigHost.StaticOpenStreamForRead(String streamName) +102
   System.Configuration.Internal.InternalConfigHost.System.Configuration.Internal.IInternalConfigHost.OpenStreamForRead(String streamName, Boolean assertPermissions) +149
   System.Configuration.BaseConfigurationRecord.InitConfigFromFile() +470

版本信息: Microsoft .NET Framework 版本:4.0.30319; ASP.NET 版本:4.8.4718.0

问题分析与解决方案 #

1. 文件锁定的根源排查 #

• ServerManager的影响：正常情况下，ServerManager.CommitChanges()采用原子更新机制——先将修改后的配置写入临时文件，再替换原web.config，这个过程只会短暂锁定文件，不会长时间占用。除非操作过程中出现异常（如磁盘IO延迟、权限不足）导致临时文件替换失败，才可能留下锁定问题，但这种情况概率极低。
• 其他进程的可能性：更常见的是第三方进程锁定文件，比如：
  • 杀毒软件的实时扫描进程
  • 系统或第三方备份工具
  • 监控类工具（如文件监控软件）
  • 异常的w3wp.exe进程（应用池进程）未正确释放文件句柄
• 排查方法：当错误出现时，使用Process Explorer工具搜索C:\MyWebSite\web.config的文件句柄，直接查看哪个进程在占用文件，就能锁定根源。

2. 无停机更新重写规则的方案 #

如果确认是ServerManager操作导致的偶发锁定，或者需要更稳妥的无停机更新方式，可以采用以下方案：

方案一：优化现有ServerManager操作

• 确保批量修改配置后一次性调用CommitChanges()，避免频繁提交导致的文件操作冲突
• 代码中已经使用using块正确释放ServerManager资源，这一点保持即可
• 给ServerManager操作添加重试逻辑，当遇到文件锁定异常时，等待1-2秒后重试，最多重试3次，避免单次失败导致的错误

方案二：手动实现原子文件替换

不依赖ServerManager的内置提交逻辑，手动完成配置更新：

1. 读取当前web.config内容，修改重写规则后写入到同目录下的web.config.new
2. 使用File.Replace("web.config.new", "web.config", "web.config.bak")完成原子替换，这个操作是系统级原子操作，不会导致文件锁定
3. IIS会自动检测到web.config变化，重新加载配置，无需重启应用池

方案三：将重写规则移至applicationHost.config

把站点的重写规则配置到服务器级别的applicationHost.config中（而非站点目录的web.config），修改时锁定的是applicationHost.config，不会影响单个站点的web.config读取。操作时依然可以使用ServerManager，但需要注意配置的权限和范围，确保站点能继承到对应的规则。

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