Azure Functions(.NET6)用自定义NuGet包遇WebJobsBuilderExtensions.cs找不到错误

针对你遇到的.NET 6 Azure Functions引用自定义NuGet包时出现的Microsoft.Extensions.Configuration.Abstractions加载失败问题，以下是具体的排查方向和解决方法：

1. 自定义NuGet包的依赖版本不兼容 #

你的自定义类库可能直接或间接依赖了7.x版本的Microsoft.Extensions.Configuration.Abstractions，而Azure Functions .NET 6运行时本身依赖的是该包的6.x版本。直接引用本地项目时，Visual Studio会自动做依赖版本统一，但NuGet包的依赖是硬声明的，导致运行时加载时版本不匹配。

• 解决：
  • 打开自定义类库的.csproj文件，将Microsoft.Extensions.Configuration.Abstractions的版本修改为与.NET 6兼容的6.x版本（比如6.0.1），重新打包发布NuGet包。
  • 如果类库必须使用7.x版本，需将Azure Functions项目升级到.NET 7，同时在.csproj中设置<AzureFunctionsVersion>v4</AzureFunctionsVersion>（v4运行时支持.NET 6/7/8）。

2. 绑定重定向未正确配置 #

即使手动安装了7.x版本，Azure Functions宿主可能未正确处理版本绑定重定向，导致依然尝试加载不匹配的版本。

• 解决：
  在Azure Functions项目的根目录（与host.json同级）添加app.config文件，写入以下绑定重定向配置：

  <?xml version="1.0" encoding="utf-8"?>
  <configuration>
    <runtime>
      <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
        <dependentAssembly>
          <assemblyIdentity name="Microsoft.Extensions.Configuration.Abstractions" publicKeyToken="adb9793829ddae60" culture="neutral" />
          <bindingRedirect oldVersion="0.0.0.0-7.0.0.0" newVersion="7.0.0.0" />
        </dependentAssembly>
      </assemblyBinding>
    </runtime>
  </configuration>
  

  然后在Functions项目的.csproj中添加配置，确保该文件被复制到输出目录：

  <ItemGroup>
    <None Update="app.config">
      <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    </None>
  </ItemGroup>
  

3. 自定义NuGet包打包不完整 #

自定义NuGet包可能未正确包含依赖项，导致运行时找不到所需的程序集。直接引用本地项目时Visual Studio会自动处理依赖，但NuGet包如果打包配置有误就会出现问题。

• 解决：
  检查自定义类库的.csproj，确保包含以下打包配置，重新用dotnet pack命令打包：

  <PropertyGroup>
    <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
    <IncludeBuildOutput>true</IncludeBuildOutput>
    <IncludeSymbols>true</IncludeSymbols>
  </PropertyGroup>
  

  也可以打开生成的.nuspec文件，确认Microsoft.Extensions.Configuration.Abstractions被列为依赖项。

4. 缓存导致的依赖解析异常 #

本地NuGet缓存或Visual Studio项目缓存损坏，可能导致依赖解析错误。

• 解决：
  • 运行命令清理NuGet缓存：dotnet nuget locals all --clear
  • 删除Azure Functions项目和自定义类库的bin/obj目录，重新生成解决方案
  • 重启Visual Studio，确保缓存被完全刷新

5. 本地Functions运行时版本问题 #

本地安装的Azure Functions Core Tools版本可能与项目依赖不匹配，导致加载失败。

• 解决：
  检查并更新Azure Functions Core Tools到最新的v4版本（支持.NET 6/7/8），可以通过npm install -g azure-functions-core-tools@4命令更新。

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