GetConnectionStringOrSetting是否已弃用？最佳替代方案是什么？

关于GetConnectionStringOrSetting的适用性 #

• 这个方法本身兼容.NET Standard，而.NET 8完全支持.NET Standard类库，技术层面可以继续使用，但它并非.NET 8 Azure Functions官方推荐的原生配置方式。
• 你遇到的UserSecrets加载失效问题，根源在于.NET 8 Azure Functions的配置模型变更：新版本宿主调整了配置源的加载顺序和优先级，导致GetConnectionStringOrSetting对接UserSecrets时出现兼容性断层。

推荐的替代方案 #

1. 使用原生配置绑定（官方推荐） #

直接通过依赖注入获取IConfiguration实例，用标准方法读取各类配置项：

public class MyTimerFunction
{
    private readonly IConfiguration _configuration;

    public MyTimerFunction(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    [Function("MyTimerTrigger")]
    public void Run([TimerTrigger("0 */5 * * * *")] TimerInfo myTimer)
    {
        // 读取连接字符串
        var dbConn = _configuration.GetConnectionString("MyDbConnection");
        // 读取层级配置项
        var apiKey = _configuration["ApiSettings:ApiKey"];
        // 读取UserSecrets中的敏感密钥
        var secretKey = _configuration["SecretSettings:SecretKey"];
    }
}

2. 修复GetConnectionStringOrSetting的UserSecrets加载问题 #

如果坚持沿用旧方法，需在项目中显式添加UserSecrets配置源：

var host = new HostBuilder()
    .ConfigureAppConfiguration((context, config) =>
    {
        // 手动添加UserSecrets配置源
        var assembly = typeof(Program).Assembly;
        config.AddUserSecrets(assembly);
    })
    .ConfigureFunctionsWorkerDefaults()
    .Build();

host.Run();

调整后，GetConnectionStringOrSetting即可正常读取UserSecrets中的配置项。

关键注意事项 #

• .NET 8 Azure Functions默认采用隔离进程的Worker Service模型，配置体系与传统.NET Worker Service对齐，使用IConfiguration原生方法更符合官方最佳实践。
• 配置优先级规则：Azure门户的应用设置 > 本地环境变量 > local.settings.json > UserSecrets，确保敏感信息不会被意外提交到代码仓库。

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