Azure Function App无法获取连接字符串：值不能为空（参数‘connectionString’）——基于DDD架构的Azure Function配置问题求助

看起来你遇到的核心问题是Azure Function的配置加载逻辑和普通ASP.NET Core应用存在差异——你的ApplicationDbContextFactory仅读取appsettings.json，但运行时Azure Function并不会自动优先加载该文件，而是依赖local.settings.json（本地开发）或云端的应用配置系统。下面分两部分给出具体的解决思路：

一、修复运行时的连接字符串读取问题 #

Azure Function在运行时（本地调试/云端部署）的配置来源规则：

• 本地环境：local.settings.json中的Values或ConnectionStrings节点（会自动映射为环境变量）
• 云端环境：Function App「应用程序设置」中的连接字符串或键值对

你需要通过依赖注入的方式让DbContext获取配置，而非硬编码读取appsettings.json：

1. 进程内Function适配（你的配置中FUNCTIONS_WORKER_RUNTIME为dotnet，属于此类） #

如果项目中没有Startup.cs，先创建该类，在其中注册DbContext时从依赖注入的IConfiguration读取连接字符串：

using Microsoft.Azure.Functions.Extensions.DependencyInjection;
using Microsoft.EntityFrameworkCore;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

[assembly: FunctionsStartup(typeof(YourNamespace.Startup))]
namespace YourNamespace
{
    public class Startup : FunctionsStartup
    {
        public override void Configure(IFunctionsHostBuilder builder)
        {
            builder.Services.AddDbContext<ApplicationDbContext>((serviceProvider, options) =>
            {
                var config = serviceProvider.GetRequiredService<IConfiguration>();
                var connectionString = config.GetConnectionString("DefaultConnection");
                
                if (string.IsNullOrWhiteSpace(connectionString))
                {
                    throw new InvalidOperationException("连接字符串'DefaultConnection'未找到或为空，请检查配置");
                }
                
                options.UseSqlServer(connectionString);
            });
        }
    }
}

2. 在Function中注入DbContext #

确保你的Function类通过构造函数注入ApplicationDbContext，而非自行调用ApplicationDbContextFactory创建实例：

public class YourFunction
{
    private readonly ApplicationDbContext _dbContext;

    // 构造函数注入DbContext
    public YourFunction(ApplicationDbContext dbContext)
    {
        _dbContext = dbContext;
    }

    [FunctionName("YourFunctionName")]
    public async Task<IActionResult> Run(
        [HttpTrigger(AuthorizationLevel.Function, "get", "post", Route = null)] HttpRequest req,
        ILogger log)
    {
        // 直接使用注入的_dbContext操作数据库
        var data = await _dbContext.YourEntities.ToListAsync();
        return new OkObjectResult(data);
    }
}

二、修复设计时（EF Core迁移）的连接字符串读取问题 #

你的ApplicationDbContextFactory目前仅读取appsettings.json，但本地开发时连接字符串通常存放在local.settings.json中，需要修改Factory使其支持多配置源读取：

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Design;
using Microsoft.Extensions.Configuration;
using System.IO;

public class ApplicationDbContextFactory : IDesignTimeDbContextFactory<ApplicationDbContext>
{
    public ApplicationDbContext CreateDbContext(string[] args)
    {
        var basePath = Directory.GetCurrentDirectory();
        
        var configuration = new ConfigurationBuilder()
            .SetBasePath(basePath)
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
            // 加入local.settings.json作为可选配置源（本地开发时生效）
            .AddJsonFile("local.settings.json", optional: true, reloadOnChange: true)
            .AddEnvironmentVariables() // 读取环境变量，适配云端迁移场景
            .Build();

        var connectionString = configuration.GetConnectionString("DefaultConnection");
        if (string.IsNullOrWhiteSpace(connectionString))
        {
            throw new InvalidOperationException("无法找到连接字符串'DefaultConnection'，请检查配置文件");
        }

        var optionsBuilder = new DbContextOptionsBuilder<ApplicationDbContext>();
        optionsBuilder.UseSqlServer(connectionString);

        return new ApplicationDbContext(optionsBuilder.Options);
    }
}

修改后，运行Add-Migration或Update-Database时就能正确读取local.settings.json中的连接字符串了。

三、额外注意事项 #

• 本地开发时，将local.settings.json的「复制到输出目录」设置为「如果较新则复制」，避免Function运行时读取不到最新配置。
• 部署到Azure时，不要上传local.settings.json，而是在Function App的「配置」→「应用程序设置」中添加连接字符串，名称设为DefaultConnection、类型选「SQL Server」，运行时会自动映射到IConfiguration中。
• 始终通过IConfiguration读取连接字符串，不要硬编码，保证多环境配置的一致性。

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