.NET Framework迁移至Azure Function Apps V4(dotnet-isolated)：ConfigurationManager失效

问题原因 #

dotnet-isolated模式的Azure Functions V4基于.NET Core/.NET 5+主机体系，而ConfigurationManager是.NET Framework的传统配置API，默认不会自动读取Azure门户注入的环境变量（带APPSETTING_、SQLAZURECONNSTR_等前缀的变量），这就是你在Kudu能看到变量但代码无法读取的核心原因。

解决方案 #

通过在函数项目的Program.cs中手动将环境变量映射到ConfigurationManager的集合中，无需修改原有依赖ConfigurationManager的代码。

步骤1：确认NuGet包 #

确保项目已安装System.Configuration.ConfigurationManager NuGet包（若未安装，可通过NuGet包管理器或命令行安装）。

步骤2：修改Program.cs配置 #

在构建函数主机时，添加配置逻辑，将环境变量中的应用设置和连接字符串注入到ConfigurationManager：

using System.Configuration;
using System.Linq;
using Microsoft.Extensions.Hosting;

var host = new HostBuilder()
    .ConfigureAppConfiguration(builder =>
    {
        // 加载所有环境变量
        var environmentVariables = builder.Build().AsEnumerable();

        // 处理应用设置：提取APPSETTING_前缀的变量
        foreach (var varPair in environmentVariables.Where(v => v.Key.StartsWith("APPSETTING_")))
        {
            var settingKey = varPair.Key.Substring("APPSETTING_".Length);
            ConfigurationManager.AppSettings[settingKey] = varPair.Value;
        }

        // 处理SQL Azure连接字符串
        foreach (var varPair in environmentVariables.Where(v => v.Key.StartsWith("SQLAZURECONNSTR_")))
        {
            var connName = varPair.Key.Substring("SQLAZURECONNSTR_".Length);
            ConfigurationManager.ConnectionStrings.Add(new ConnectionStringSettings(
                connName,
                varPair.Value,
                "System.Data.SqlClient"));
        }

        // 处理本地SQL Server连接字符串（可选）
        foreach (var varPair in environmentVariables.Where(v => v.Key.StartsWith("SQLCONNSTR_")))
        {
            var connName = varPair.Key.Substring("SQLCONNSTR_".Length);
            ConfigurationManager.ConnectionStrings.Add(new ConnectionStringSettings(
                connName,
                varPair.Value,
                "System.Data.SqlClient"));
        }

        // 处理MySQL连接字符串（可选）
        foreach (var varPair in environmentVariables.Where(v => v.Key.StartsWith("MYSQLCONNSTR_")))
        {
            var connName = varPair.Key.Substring("MYSQLCONNSTR_".Length);
            ConfigurationManager.ConnectionStrings.Add(new ConnectionStringSettings(
                connName,
                varPair.Value,
                "MySql.Data.MySqlClient"));
        }

        // 处理自定义连接字符串（可选）
        foreach (var varPair in environmentVariables.Where(v => v.Key.StartsWith("CUSTOMCONNSTR_")))
        {
            var connName = varPair.Key.Substring("CUSTOMCONNSTR_".Length);
            ConfigurationManager.ConnectionStrings.Add(new ConnectionStringSettings(
                connName,
                varPair.Value,
                string.Empty)); // 根据实际场景设置ProviderName
        }
    })
    .ConfigureFunctionsWorkerDefaults()
    .Build();

host.Run();

说明 #

• 这段代码会自动识别Azure门户配置的应用设置（对应APPSETTING_前缀环境变量）和各类连接字符串（对应不同前缀的环境变量），并将它们添加到ConfigurationManager的对应集合中。
• 本地开发时，local.settings.json中的Values和ConnectionStrings会自动转换为带对应前缀的环境变量，因此这段代码在本地和Azure环境中都能生效。
• 原有依赖ConfigurationManager.AppSettings["my_setting"]或ConfigurationManager.ConnectionStrings["my_connection_string"]的代码无需任何修改，即可正常获取配置值。

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