如何从local.settings.json获取Connectionstring值？已尝试方法均返回Null

API 探路者

2026-6-24

解决local.settings.json自定义节点读取返回Null的问题

问题根源

Azure Functions的local.settings.json中，只有Values节点下的键值对会被自动加载到环境变量，也只有这个节点的内容能通过config.GetSection()、Environment.GetEnvironmentVariable()这类默认方法直接读取。你自定义的Connectionstring节点不在默认加载范围内，所以调用这些方法会返回Null。

解决方法

方法一：将连接字符串移到`Values`节点（推荐）

修改local.settings.json，把连接字符串放到Values里，可遵循Azure Functions的命名惯例（用ConnectionStrings:前缀）：

{
    "Values": {
        "Name": "test",
        "ConnectionStrings:Myconnection": "myconnectionstring"
    }
}

读取方式：

使用环境变量：

string connStr = Environment.GetEnvironmentVariable("ConnectionStrings:Myconnection");

使用配置对象：

string connStr = config.GetSection("ConnectionStrings").GetValue<string>("Myconnection");
// 或者直接取值
string connStr = config.GetValue<string>("ConnectionStrings:Myconnection");

方法二：手动加载整个配置文件（仅本地调试用）

如果要保留原Connectionstring节点结构，需要手动构建配置对象来读取整个local.settings.json：

var configBuilder = new ConfigurationBuilder()
    .SetBasePath(Directory.GetCurrentDirectory())
    .AddJsonFile("local.settings.json", optional: true, reloadOnChange: true)
    .AddEnvironmentVariables();

IConfiguration config = configBuilder.Build();
string connStr = config.GetSection("Connectionstring")["Myconnection"];