WinSW服务因stdout/stderr日志文件被锁触发未处理IOException崩溃的优雅处理方案咨询

从你排查的过程来看，已经把问题定位得非常精准了——WinSW的日志模块在尝试写入stdout/stderr日志时遭遇文件锁，抛出未处理的System.IO.IOException直接导致服务崩溃。既要保留日志能力，又要让服务优雅应对这种异常，试试下面这些可行的方案：

1. 调整WinSW日志模式与锁策略 #

WinSW本身支持日志轮换和独占写入配置，能有效降低文件锁冲突的概率，同时优化异常处理逻辑：

• 把原有的reset日志模式改成roll-by-size或roll-by-time，自动分割日志文件，减少单文件被长期占用的情况
• 启用日志文件的独占写入配置，避免外部进程随意锁定日志，同时让WinSW在遇到锁时尝试重试而非直接崩溃

修改你的日志配置段为：

<logpath>%PROGRAMDATA%\path\log\service</logpath>
<!-- 按大小轮换日志：单文件最大100MB，保留最近10个日志文件 -->
<log mode="roll-by-size">
  <sizeThreshold>104857600</sizeThreshold>
  <keepFiles>10</keepFiles>
  <!-- 启用独占写入，同时触发WinSW的锁冲突重试逻辑 -->
  <enableFileLocking>true</enableFileLocking>
</log>

注意：建议升级到WinSW v2.12+版本，该版本对日志锁的异常处理做了优化，重试逻辑更完善

2. 启用WinSW日志重试扩展（适用于v2.12+/v3.x） #

如果你的WinSW版本支持扩展，可以添加日志重试扩展，让服务在写入失败时自动重试，多次失败后降级到事件日志，避免崩溃：
在现有<extensions>节点中添加以下配置：

<extensions>
  <!-- 保留你已配置的RunawayProcessKiller -->
  <extension enabled="true" className="winsw.Plugins.RunawayProcessKiller.RunawayProcessKillerExtension" id="killOnStartup">
    <pidfile>%BASE%\pid.txt</pidfile>
    <stopTimeout>5000</stopTimeout>
    <stopParentFirst>true</stopParentFirst>
  </extension>
  <!-- 添加日志重试扩展：重试3次，间隔1秒，失败则转事件日志 -->
  <extension enabled="true" className="winsw.Plugins.Logging.RetryingFileAppenderExtension" id="retryLog">
    <retryCount>3</retryCount>
    <retryInterval>1000</retryInterval>
    <fallbackToEventLog>true</fallbackToEventLog>
  </extension>
</extensions>

3. 完全绕开文件日志：转用Windows事件日志 #

如果文件锁问题始终无法彻底规避，可以直接把WinSW的日志输出重定向到Windows事件日志，完全摆脱文件锁的困扰：
替换原日志配置为：

<log mode="eventlog">
  <eventLog>Application</eventLog>
  <eventSource>{{name}}</eventSource>
</log>

这种方式依赖系统自带的事件日志机制，日志可以通过事件查看器统一管理，可靠性更高，也不存在文件锁冲突的问题。

4. 前置日志锁检查脚本 #

在WinSW启动服务前，添加预启动脚本自动检查并释放日志文件的锁：
在配置中加入<prestart>节点：

<prestart>
  <executable>%BASE%\scripts\clear-log-lock.bat</executable>
  <arguments>%PROGRAMDATA%\path\log\service\agent.out.log %PROGRAMDATA%\path\log\service\agent.err.log</arguments>
</prestart>

对应的clear-log-lock.bat可以借助handle.exe（Sysinternals工具）来清理锁：

@echo off
set OUT_LOG=%1
set ERR_LOG=%2

:: 检查并释放日志文件的锁
handle.exe -c %OUT_LOG% -y >nul 2>&1
handle.exe -c %ERR_LOG% -y >nul 2>&1

需要把handle.exe放到脚本可访问的路径下

额外优化建议 #

• 确保使用WinSW最新稳定版，旧版本的日志模块确实存在未处理IO异常的bug
• 配合<stopparentprocessfirst>true</stopparentprocessfirst>配置，让WinSW停止服务时先终止子进程，再清理自身资源，减少孤儿进程残留锁的情况
• 多做几次锁场景模拟测试，验证方案的有效性，确保服务在日志被锁时能正常运行而非崩溃

内容来源于stack exchange