.Net 6 API部署失败：IIS进程w3wp.exe锁定主DLL问题排查求助

排查锁定原因的核心步骤 #

• 检查IIS应用池与站点状态：先手动回收目标应用池再尝试部署，若仍锁定，检查站点是否开启预加载——开启预加载的站点会持续持有DLL，需先停止站点再部署。另外确认应用池的「禁用重叠回收」是否开启，重叠回收会让旧进程等待新进程启动，可能导致短暂锁定；若为持续锁定，需排查进程僵死情况。
• 排查代码资源泄漏：即使遵循最佳实践，也可能存在遗漏：
  • 代码中直接读取bin目录内文件（如自定义配置、本地日志）但未用using/await using正确释放流对象
  • 第三方NuGet包或组件内部持有DLL句柄（部分监控、序列化组件可能存在此类问题）
  • 缓存组件若缓存了包含未释放资源的对象实例，也可能间接锁定DLL
• 检查调试/诊断工具残留：若服务器曾用远程调试器附加过w3wp进程，或性能分析工具（如Profiler）未正常关闭，会持续锁定DLL。
• 验证异步代码资源释放：确认所有异步操作中的文件、网络资源都用await using包裹，避免因异步回调延迟导致的资源未释放。

服务器端辅助定位工具 #

• Process Explorer：找到w3wp.exe进程，右键选择「Find Handle or DLL」，输入被锁定的DLL文件名，可直接定位到持有句柄的线程和具体信息。
• Resource Monitor：切换到「CPU」选项卡，找到目标w3wp进程，展开后查看「关联的句柄」，筛选DLL文件名即可锁定具体句柄。
• Handle.exe（Sysinternals工具）：命令行执行handle.exe -p <w3wp进程ID> <目标DLL文件名>，直接输出锁定文件的句柄ID及相关进程细节。
• dotnet-dump：通过dotnet-dump collect -p <w3wp进程ID>生成进程dump，分析是否存在未释放的对象持有文件句柄。
• IIS管理器：查看应用池的「进程模型」配置（闲置超时、回收间隔），同时检查当前是否有多个w3wp进程（重叠回收残留）。

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