排查.NET/C# Windows Service的MSI安装错误1001问题

遇到这种Error 1001的问题确实让人头大，尤其是你已经定位到是新增特定代码引发的情况。下面几个方法能帮你获取到更详细的错误信息，精准定位根因：

• 捕获LoaderException的详细日志
  错误提示里提到的LoaderExceptions是关键信息来源。你可以修改服务项目中的Installer类，重写Install方法来捕获并记录这些异常详情：

  public override void Install(IDictionary stateSaver)
  {
      try
      {
          base.Install(stateSaver);
      }
      catch (Exception ex)
      {
          if (ex is ReflectionTypeLoadException reflectionLoadEx)
          {
              var errorLog = new StringBuilder("安装程序加载异常详情:\n");
              foreach (var loaderEx in reflectionLoadEx.LoaderExceptions)
              {
                  errorLog.AppendLine($"---\n异常信息: {loaderEx.Message}");
                  errorLog.AppendLine($"堆栈跟踪:\n{loaderEx.StackTrace}\n");
              }
              // 将日志写入本地可访问的路径，比如临时文件夹
              File.WriteAllText(Path.Combine(Path.GetTempPath(), "ServiceInstallErrors.txt"), errorLog.ToString());
          }
          throw; // 继续抛出原异常，不中断安装流程的错误提示
      }
  }
  

  修改后重新生成MSI安装包，再次运行安装，之后去指定路径查看日志，就能看到具体是哪个程序集加载失败、失败原因是什么（比如缺失依赖、版本不兼容、权限不足等）。

• 使用Fusion日志查看程序集加载过程
  Windows自带的Fusion Log Viewer可以全程追踪程序集加载情况，步骤如下：

  1. 以管理员身份打开命令提示符，运行fuslogvw.exe启动工具
  2. 在工具中点击“Settings”，选择“Log bind failures to disk”，可以设置日志存储路径
  3. 运行你的MSI安装包，触发错误后回到Fusion Log Viewer，点击“Refresh”就能看到所有加载失败的程序集记录，每条记录会详细说明失败原因

• 针对性排查新增代码的依赖
  既然问题是添加特定代码后出现的，优先检查这段代码引入的依赖：

  • 确认新增代码引用的第三方库或自定义程序集是否被正确包含在MSI安装包中（在安装项目中要确保这些程序集被添加为项目输出或文件，且Copy Local属性设为True）
  • 检查目标机器是否安装了这些依赖需要的.NET运行时版本，比如你用了.NET 6的库，目标机器却只有.NET Framework 4.8
  • 如果是强名称程序集，确认开发环境和目标机器上的程序集版本、公钥是否一致

• 本地提前验证程序集加载
  不用每次都生成MSI测试，你可以写一个简单的控制台程序来模拟加载服务程序集，提前捕获异常：

  using System.Reflection;
  using System.Text;
  
  try
  {
      var serviceAssembly = Assembly.LoadFrom(@"C:\Path\To\Your\Service.exe");
      // 尝试获取安装程序类型，模拟MSI的加载逻辑
      var installerTypes = serviceAssembly.GetTypes().Where(t => typeof(System.Configuration.Install.Installer).IsAssignableFrom(t));
      Console.WriteLine("成功找到安装程序类型");
  }
  catch (ReflectionTypeLoadException ex)
  {
      var errorInfo = new StringBuilder();
      foreach (var loaderEx in ex.LoaderExceptions)
      {
          errorInfo.AppendLine($"加载异常: {loaderEx.Message}\n{loaderEx.StackTrace}\n");
      }
      Console.WriteLine(errorInfo.ToString());
  }
  catch (Exception ex)
  {
      Console.WriteLine($"其他异常: {ex.ToString()}");
  }
  

  运行这个控制台程序，就能直接看到加载失败的具体原因，快速排查问题。

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