.NET 6升级到.NET 8后无法引用builder.ConfigurationBuilder问题

排查与修复步骤 #

1. 核对项目基础配置与依赖包 #

• 打开项目.csproj文件，确认以下配置：
  • <AzureFunctionsVersion>v4</AzureFunctionsVersion>
  • <TargetFramework>net8.0</TargetFramework>
  • <FunctionsWorkerRuntime>dotnet</FunctionsWorkerRuntime>（非独立进程模式）
• 检查NuGet包版本：
  • Microsoft.Azure.Functions.Extensions需升级到4.1.1及以上（适配.NET 8）
  • Microsoft.Extensions.Configuration.*系列包统一使用8.x版本，避免版本不兼容

2. 调整Startup类的配置逻辑 #

在.NET 8的非独立进程Functions中，直接调用builder.ConfigurationBuilder.AddEnvironmentVariables()可能因重复注册配置源引发冲突，推荐写法如下：

public class Startup : FunctionsStartup
{
    public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)
    {
        var context = builder.GetContext();
        
        // 本地开发加载local.settings.json，生产环境宿主自动处理环境变量
        builder.ConfigurationBuilder
            .SetBasePath(context.ApplicationRootPath)
            .AddJsonFile("local.settings.json", optional: true, reloadOnChange: true);
        
        // 若有特殊环境变量前缀需求，可添加带前缀的重载，否则无需手动调用AddEnvironmentVariables
        // .AddEnvironmentVariables("YOUR_CUSTOM_PREFIX_");
    }

    public override void Configure(IFunctionsHostBuilder builder)
    {
        // 此处添加服务注册逻辑
    }
}

3. 清理本地环境重新构建 #

• 删除项目根目录下的bin和obj文件夹
• 打开终端执行func clean清除Functions本地工具缓存
• 重新构建并运行项目

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