.NET 8 Windows服务无法启动（System.IO.IOException异常）

这个错误的核心原因是Windows服务运行时没有关联的控制台窗口，而代码（或隐式初始化逻辑）尝试调用了依赖控制台句柄的操作（比如设置Console.OutputEncoding），导致抛出句柄无效的异常。以下是几种可行的解决方案：

• 移除或条件化控制台编码设置
  检查你的代码（尤其是Program.cs或服务启动入口）是否存在直接设置Console.OutputEncoding的代码。如果有，要么直接移除，要么添加条件判断，仅在非服务模式下执行：

  if (!WindowsServiceHelpers.IsWindowsService())
  {
      Console.OutputEncoding = Encoding.UTF8;
  }
  

• 配置项目为Windows服务专用输出类型
  在项目文件（.csproj）中添加或修改以下配置，确保发布的是Windows服务而非控制台应用：

  <PropertyGroup>
      <OutputType>WinExe</OutputType>
      <RuntimeIdentifier>win-x64</RuntimeIdentifier>
      <!-- 可选：单文件发布配置 -->
      <PublishSingleFile>true</PublishSingleFile>
      <SelfContained>true</SelfContained>
  </PropertyGroup>
  

  或者使用命令行发布时明确指定参数：

  dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:OutputType=WinExe
  

  设置OutputType为WinExe会跳过控制台相关的初始化流程，避免触发异常。

• 重定向Console输入输出到空设备
  如果无法定位到具体的控制台调用代码（比如第三方库隐式调用），可以在服务启动的最早期添加以下代码，将Console的输入输出重定向到空设备：

  Console.SetOut(TextWriter.Null);
  Console.SetIn(TextReader.Null);
  

  这样即使有代码尝试访问Console，也不会因为找不到有效句柄而报错。

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