.NET 8函数应用加载Microsoft.Extensions.Options 8.0.0程序集失败求助

1. 核对项目依赖配置 #

• 打开函数应用和类库的.csproj文件，确认Microsoft.Extensions.Options的引用配置正确，并且确保依赖会被拷贝到输出目录：

  <PackageReference Include="Microsoft.Extensions.Options" Version="8.0.0">
    <PrivateAssets>all</PrivateAssets>
    <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
  </PackageReference>
  

• 编译后去类库的输出目录（比如bin/Debug/net8.0）检查是否存在Microsoft.Extensions.Options.dll，没有的话重新核对引用配置。

2. 确认运行环境兼容性 #

• 本地使用Azure Functions Core Tools运行时，执行func --version查看版本，必须是4.0.5455及以上才支持.NET 8，版本不足直接去官网更新工具。
• 如果部署到Azure，检查函数应用的运行时堆栈是否选择了.NET 8 Isolated或.NET 8 In-Process，要和你的项目模型匹配。

3. 添加程序集绑定重定向（按需） #

• 若使用In-Process模型的函数应用，在web.config中添加绑定重定向，强制指向8.0.0版本：

  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <dependentAssembly>
        <assemblyIdentity name="Microsoft.Extensions.Options" publicKeyToken="adb9793829ddae60" culture="neutral" />
        <bindingRedirect oldVersion="0.0.0.0-8.0.0.0" newVersion="8.0.0.0" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
  

• Isolated模型无需配置web.config，依赖由项目本身处理。

4. 清空本地运行缓存 #

• 本地运行的缓存可能存在残留，直接删除以下目录：
  • Windows：%LOCALAPPDATA%\AzureFunctionsTools\Releases 和 %TEMP%\AzureFunctions
  • macOS/Linux：~/.azurefunctions 和 /tmp/AzureFunctions
• 删除后重新构建发布项目，确保所有依赖正确拷贝到输出目录。

5. 排查依赖冲突 #

• 执行dotnet list package --include-transitive命令查看项目完整依赖树，检查是否有其他包引用了旧版本的Microsoft.Extensions.Options导致版本冲突。
• 若发现冲突，在.csproj中给冲突的包添加版本覆盖，强制统一使用8.0.0版本：

  <PackageReference Include="Microsoft.Extensions.Options" Version="8.0.0" />
  <PackageReference Include="冲突的包名" Version="对应版本">
    <VersionOverrides>
      <PackageReference Include="Microsoft.Extensions.Options" Version="8.0.0" />
    </VersionOverrides>
  </PackageReference>
  

6. 彻底清理重建 #

• 执行以下命令彻底清理缓存并重建项目：

  dotnet clean
  dotnet nuget locals all --clear
  dotnet restore
  dotnet build --no-incremental
  

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