VS2022 17.0.0编译Azure Function v4隔离进程报错MSB4062如何解决

问题背景 #

使用Visual Studio 2022 Enterprise 17.0.0版本编译Azure Function v4隔离进程（out-of-process）项目时出现编译失败，错误代码为MSB4062。

项目配置 #

.csproj定义 #

<PropertyGroup>
    <TargetFramework>net6.0</TargetFramework>
    <LangVersion>10.0</LangVersion>
    <AzureFunctionsVersion>v4</AzureFunctionsVersion>
     <OutputType>Exe</OutputType>
    <_FunctionsSkipCleanOutput>true</_FunctionsSkipCleanOutput>
    <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
</PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.Azure.Functions.Extensions" Version="1.1.0" />
    <PackageReference Include="Microsoft.NET.Sdk.Functions" Version="4.0.1" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.6.0" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.3.0" OutputItemType="Analyzer" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.0.13" />
    <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Timer" Version="4.1.0" />
  </ItemGroup>

Program.cs初始化代码 #

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureAppConfiguration((context, configure) =>
    {
        configure
        .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
        .AddJsonFile($"appsettings.{context.HostingEnvironment.EnvironmentName}.json", optional: true, reloadOnChange: true)
        .AddEnvironmentVariables();
    })
    .ConfigureServices((context, services) =>
    {
          services.AddMyServices();
    })
    .Build();

报错信息 #

严重性 代码 说明 项目 文件 行 禁止显示状态
错误 MSB4062 未能从程序集C:\Users\myusername.nuget\packages\microsoft.net.sdk.functions\4.0.1\build..\tools\net6.0\Microsoft.NET.Sdk.Functions.MSBuild.dll加载"GenerateFunctionMetadata"任务。请确认声明正确，该程序集及其所有依赖项均可用，且任务包含实现Microsoft.Build.Framework.ITask的公共类。 MyApp.Functions C:\Users\myusername.nuget\packages\microsoft.azure.functions.worker.sdk\1.3.0\build\Microsoft.Azure.Functions.Worker.Sdk.targets 60

排查与解决方向 #

• 移除冲突的Nuget包：Microsoft.NET.Sdk.Functions和Microsoft.Azure.Functions.Extensions是Azure Function进程内运行模型的依赖包，隔离进程模型无需引入，直接删除这两个包的引用即可解决核心冲突。
• 清理损坏的Nuget缓存：关闭Visual Studio后删除路径C:\Users\myusername.nuget\packages\microsoft.net.sdk.functions\4.0.1下的缓存文件，或执行nuget locals all -clear全局清理Nuget缓存，之后重新还原项目依赖。
• 更新隔离进程相关包版本：将Microsoft.Azure.Functions.Worker、Microsoft.Azure.Functions.Worker.Sdk以及对应的扩展包升级到最新稳定版，旧版本1.3.0的Worker SDK存在与MSBuild任务兼容的已知问题。
• 检查项目SDK声明：确认.csproj文件头部的SDK声明为<Project Sdk="Microsoft.Azure.Functions.Worker.Sdk">，而非默认的Microsoft.NET.Sdk，这是隔离进程项目的强制要求。
• 验证开发环境组件：确认Visual Studio 2022已安装Azure开发工作负载，且.NET 6 SDK完整安装无缺失。

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