独立模式Azure Function启动时抛出'Method not found'错误求助

问题描述 #

将C# Azure Functions从进程内模式迁移至独立模式时，启动出现如下错误：

Method not found: 'Microsoft.Extensions.DependencyInjection.IServiceCollection Microsoft.Extensions.DependencyInjection.ServiceCollectionExtensions.RegisterDefaultConverters(Microsoft.Extensions.DependencyInjection.IServiceCollection)'.

你的Program.cs代码是标准的独立模式启动代码，无语法问题：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .Build();
await host.RunAsync();

问题根源在于NuGet包版本不兼容，核心Worker包版本过低，且部分扩展包版本与核心包不匹配。

解决方案 #

1. 升级核心Worker包 #

Microsoft.Azure.Functions.Worker和Microsoft.Azure.Functions.Worker.Sdk是独立模式的核心依赖，旧版本（如你使用的1.6.0和1.3.0）未包含RegisterDefaultConverters方法，需升级至兼容版本（推荐最新稳定版）：

• 将Microsoft.Azure.Functions.Worker升级至1.10.0及以上
• 将Microsoft.Azure.Functions.Worker.Sdk同步升级至对应匹配版本（例如Worker 1.19.0对应Sdk 1.14.0）

2. 对齐扩展包版本 #

确保所有Worker扩展包与核心Worker版本兼容，同时清理冗余包：

• 移除重复的存储扩展包（保留Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues即可，无需同时引用Microsoft.Azure.Functions.Worker.Extensions.Storage）
• 将预览版的Application Insights扩展替换为稳定版
• 升级DurableTask、CosmosDB等扩展包到最新稳定版

3. 清理并还原依赖 #

• 删除项目目录下的bin和obj文件夹
• 运行dotnet restore重新安装所有依赖包

修改后的.csproj示例 #

<PackageReference Include="Microsoft.Azure.AppConfiguration.Functions.Worker" Version="6.0.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.ApplicationInsights" Version="2.0.1" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.DurableTask" Version="1.1.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.CosmosDB" Version="4.3.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues" Version="5.2.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.19.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.1.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Timer" Version="4.3.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Warmup" Version="4.1.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.14.0" />
<PackageReference Include="Newtonsoft.Json" Version="13.0.3" />

原因说明 #

RegisterDefaultConverters方法是在较新版本的Azure Functions Worker SDK中引入的，用于注册默认类型转换器。你的旧版本核心Worker包未包含该方法，但部分扩展包（如DurableTask、AppConfiguration）依赖此方法，导致启动时出现方法未找到的异常。统一升级核心包和扩展包版本即可解决版本不兼容问题。

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