调用Microsoft.Extensions.Hosting.HostBuilder.Build()触发参数空异常求助

异常核心原因定位 #

异常Value cannot be null. Parameter name: configureDelegate出现在HostBuilder.ConfigureServices(Action<HostBuilderContext, IServiceCollection>)方法中，但你的代码调用的是ConfigureServices(Action<IServiceCollection>)重载——这说明服务器上的Microsoft.Extensions.Hosting程序集版本/实现与你本地调试的5.0版本不一致，或者程序集加载过程中出现异常，导致委托隐式转换时出现null。

排查与修复步骤 #

1. 验证程序集版本与绑定重定向 #

• 检查服务器服务目录下所有Microsoft.Extensions.*系列dll的版本，确保全部为5.0.x.x，无3.1/6.0等其他版本混杂。
• 确认app.config中存在正确的绑定重定向配置，强制CLR加载指定版本的程序集：

  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="Microsoft.Extensions.Hosting" publicKeyToken="adb9793829ddae60" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-5.0.0.0" newVersion="5.0.0.0" />
      </dependentAssembly>
      <!-- 为所有Microsoft.Extensions.*组件添加类似的绑定重定向 -->
    </assemblyBinding>
  </runtime>
  

2. 显式使用匹配的委托重载 #

修改ConfigureHostService方法签名，直接匹配HostBuilder.ConfigureServices的双参数重载，避免隐式转换可能带来的问题：

private static void ConfigureHostService(HostBuilderContext context, IServiceCollection services)
{
    services.AddHttpClient();
}

调用时保持不变：hostBuilder.ConfigureServices(ConfigureHostService);

3. 排查程序集加载异常 #

使用Fusion Log Viewer（fuslogvw.exe） 捕获服务器上的程序集绑定日志，查看是否存在Microsoft.Extensions.Hosting或服务自身程序集的加载失败、版本不匹配等问题。操作步骤：

• 以管理员身份运行fuslogvw.exe
• 勾选“启用程序集绑定失败日志记录”，选择“记录到磁盘”
• 启动服务触发异常后，查看日志定位具体加载错误

4. 检查程序集完整性 #

服务器上的Microsoft.Extensions.Hosting.dll可能因磁盘错误、部署异常导致损坏，重新从本地开发环境拷贝完整的5.0版本dll覆盖服务器文件，确保文件哈希一致。

5. 增加调试日志 #

在CreateHost方法中添加日志，确认委托状态：

private static void CreateHost()
{
    lock (_hostSyncObject)
    {
        if (_serviceHost == null)
        {
            HostBuilder hostBuilder = new HostBuilder();
            // 检查委托是否为null并记录日志
            var configureAction = new Action<HostBuilderContext, IServiceCollection>(ConfigureHostService);
            if (configureAction == null)
            {
                // 写入错误日志，例如EventLog
                EventLog.WriteEntry("YourServiceName", "ConfigureHostService delegate is null!", EventLogEntryType.Error);
            }
            hostBuilder.ConfigureServices(configureAction);
            _serviceHost = hostBuilder.Build();
        }
    }
}

6. 检查GAC中的冲突程序集 #

查看服务器全局程序集缓存（GAC）中是否存在其他版本的Microsoft.Extensions.Hosting，如果有，可通过gacutil /u Microsoft.Extensions.Hosting,Version=x.x.x.x卸载，避免CLR优先加载GAC中的旧版本。

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