解决NET Core发布iis项目覆盖原有的项目时"另

lcysts
9
2025-07-17

解决NET Core发布iis项目覆盖原有的项目时"另一个程序正在使用此文件,进程无法访问"

现在net core运用的多了,一系列的问题接踵而来,更新项目发布到iis时就有一个坑。

应急办法是直接停站点进行发布。

但是这样做会导致,部署项目停的时间过长,网站暂时没法访问。(项目发布完成后记得“启动”)


查询官方文档后,官方给出的方案:

锁定的部署文件

如果应用正在运行,部署文件夹中的文件会被锁定。 在部署期间,无法覆盖已锁定的文件。 若要在部署中解除已锁定的文件,请使用以下方法之一 停止应用池:

  • 使用 Web 部署并在项目文件中引用 Microsoft.NET.Sdk.Web。 系统会在 Web 应用目录的根目录中放置一个 app_offline.htm 文件 。 该文件存在时,ASP.NET Core 模块会在部署过程中正常关闭该应用并提供 app_offline.htm 文件 。 有关详细信息,请参阅 ASP.NET Core 模块配置参考
  • 在服务器上的 IIS 管理器中手动停止应用池。
  • 使用 PowerShell 删除 app_offline.html (需要使用 PowerShell 5 或更高版本):
  1. $pathToApp = 'PATH_TO_APP'


  2. # Stop the AppPool

  3. New-Item -Path $pathToApp app_offline.htm


  4. # Provide script commands here to deploy the app


  5. # Restart the AppPool

  6. Remove-Item -Path $pathToApp app_offline.htm


我们在 IIS ASP.NET 核心模块中添加了一项新功能,以添加对卷影复制应用程序程序集的支持。目前,.NET 在 Windows 上运行时会锁定应用程序二进制文件,因此当应用程序仍在运行时,无法替换二进制文件。虽然我们的建议仍然是使用应用脱机文件,但我们认识到在某些情况下(例如 FTP 部署)无法执行此操作。

在这种情况下,可以通过自定义 ASP.NET 核心模块处理程序设置来启用卷影复制。在大多数情况下,ASP.NET 核心应用程序没有签入到源代码管理中的 web.config,您可以对其进行修改(它们通常由 SDK 生成)。可以添加此示例以开始使用。<span>web<span>.<span>config</span></span></span>

复制代码

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <!-- To customize the asp.net core module uncomment and edit the following section. 
  For more info see https://go.microsoft.com/fwlink/?linkid=838655 -->

  <system.webServer>
    <handlers>
      <remove name="aspNetCore"/>
      <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModulev2" resourceType="Unspecified"/>
    </handlers>
    <aspNetCore processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" stdoutLogEnabled="false" stdoutLogFile=".\logs\stdout">
      <handlerSettings>
        <handlerSetting name="experimentalEnableShadowCopy" value="true" />
        <handlerSetting name="shadowCopyDirectory" value="../ShadowCopyDirectory/" />
        <!-- Only enable handler logging if you encounter issues-->
        <!--<handlerSetting name="debugFile" value=".\logs\aspnetcore-debug.log" />-->
        <!--<handlerSetting name="debugLevel" value="FILE,TRACE" />-->
      </handlerSettings>
    </aspNetCore>
  </system.webServer>
</configuration>

复制代码

注意:processPath="%LAUNCHER_PATH%" arguments="%LAUNCHER_ARGS%" 要更改为
processPath="dotnet" arguments=".\GamePlayer.Web.dll"

GamePlayer.Web.dll 为你项目的DLL名称

../ShadowCopyDirectory/ 也可以更改为你自己存放副本的目录

否则会报错

已测试,好用

结合官方文档,找到了一个目前看算是比较好的解决方案

好点的解决方案(一次配置后,1秒钟更新):

  1. 在D盘根目录创建一个app_offline.htm文件,注意是.htm文件,不是.html
  2. 创建一个待发布文件夹,把需要更新的项目文件放到该目录下
  3. 创建一个bat执行文件,内容如下,通过bat文件完成更新

bat执行文件内容,直接拷贝后替换路径即可

  1. @echo off

  2. call xcopy D:\app_offline.html D:\运行的项目

  3. call xcopy D:\待发布项目 D:\运行的项目 /s /e /Q /Y /I

  4. del D:\运行的项目\app_offline.htm


bat文件对应每一行的注释:

  1. 复制D盘根目录的app_offline.htm文件到项目运行的目录,接管所有的请求
  2. 复制待发布的文件到项目运行的目录完成覆盖更新
  3. 删除app_offline.htm文件恢复项目正常运行

注意:iis发布net core时,应用程序池的版本为【无托管代码】,托管管道模式选为【集成】,如下图:

动物装饰