Windows服务发布模式下Hangfire Server无法拾取作业求助

看起来你碰到的是发布模式特有的程序集加载缺失问题——调试模式下Visual Studio会自动处理依赖复制，但发布模式的优化、打包规则经常会导致这类加载失败。下面是一步步的排查和解决思路：

1. 先确认依赖项的复制配置 #

• 检查Windows服务项目里对共享库的引用：右键该引用 → 属性 → 把「复制本地」设置为True。发布模式下这个选项直接决定共享库的DLL会不会被拷贝到发布目录，很多时候就是这里没设置导致的。
• 发布完成后打开输出文件夹，确认共享库的DLL以及它依赖的第三方NuGet包DLL都存在于目录中，缺哪个补哪个。

2. 关闭可能导致程序集裁剪的发布优化 #

发布模式默认的代码优化可能会误删Hangfire需要的作业相关代码：

• 右键Windows服务项目 → 属性 → 发布 → 点击「显示所有设置」→ 取消勾选「裁剪未使用的代码」。
• 如果是.NET Core/.NET 5+项目，还要检查项目文件里的<PublishTrimmed>是否设为False，避免程序集被自动裁剪。

3. 确保Hangfire能正确定位作业程序集 #

发布后程序集的名称、版本或者路径变化，可能导致Hangfire找不到作业所在的程序集：

• 确认共享库发布后的程序集名称、版本和调试时一致，避免Hangfire作业存储里记录的程序集信息和实际不匹配。
• 可以手动指定Hangfire的程序集加载逻辑，比如在服务启动时添加自定义激活器：

  GlobalConfiguration.Configuration
      .UseSqlServerStorage("你的连接字符串")
      .UseJobActivator(new CustomJobActivator());
  

  自定义激活器从服务运行目录加载程序集：

  public class CustomJobActivator : IJobActivator
  {
      public object ActivateJob(Type jobType)
      {
          var assemblyPath = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, $"{jobType.Assembly.GetName().Name}.dll");
          var targetAssembly = Assembly.LoadFrom(assemblyPath);
          return Activator.CreateInstance(targetAssembly.GetType(jobType.FullName));
      }
  }
  

4. 排查服务运行目录的权限问题 #

有时候发布目录的权限不足，导致服务无法读取DLL文件：

• 右键Windows服务 → 属性 → 登录 → 确保运行服务的账户（比如LocalSystem）对发布目录有读取和执行权限。
• 可以手动在发布目录里双击运行服务的EXE，看看能不能正常启动，排除服务账户的权限问题。

5. 用程序集绑定日志定位具体问题 #

如果以上方法都没解决，直接用工具抓加载日志：

• 以管理员身份打开命令提示符，运行：

  fuslogvw.exe
  

  这是.NET自带的程序集绑定日志查看器，设置好日志路径后启动服务，就能看到具体哪个程序集加载失败、尝试了哪些路径，精准定位问题根源。

内容的提问来源于stack exchange，提问作者I Love Stackoverflow