部署至Azure时DBContext连接字符串配置失效问题求助

你的核心问题是：多项目.NET应用部署到Azure App Service后，仅硬编码连接字符串到DbContext的OnConfiguring方法才生效，无法通过配置文件、DI注入或Azure环境变量/连接字符串读取正确的连接信息，且Azure中部分环境变量能正常读取但连接字符串相关变量不行。

关键问题点 #

1. DbContext构造函数存在歧义，导致DI容器无法正确解析带配置的构造函数
2. Azure App Service中连接字符串与环境变量的配置区域混淆，读取方式不匹配
3. 多项目场景下设计时工厂的配置路径错误（仅影响本地迁移，不影响Azure部署）
4. 冗余的OnConfiguring方法覆盖了DI注入的配置选项

分步解决方案 #

1. 清理DbContext构造函数，消除DI歧义 #

保留仅需要的构造函数，避免容器无法正确匹配：

// 移除空构造函数和非泛型的DbContextOptions构造函数
public PeakedDbContext(DbContextOptions<PeakedDbContext> options, ICurrentUserService currentUserService) 
    : base(options)
{
    _currentUserService = currentUserService;
}

注：如果需要支持无依赖的场景（如手动实例化），可以保留带泛型DbContextOptions<PeakedDbContext>的独立构造，但优先使用DI注入的构造。

2. 修正OnConfiguring方法（可选，仅做 fallback） #

如果保留OnConfiguring，确保仅在未通过DI注入配置时生效，避免覆盖正确配置：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    // 仅当没有已配置的选项时才执行
    if (!optionsBuilder.IsConfigured)
    {
        // 本地开发时从配置读取，Azure部署时不会走到这里
        var configuration = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json")
            .Build();
            
        optionsBuilder.UseSqlServer(
            configuration.GetConnectionString("defaultConnection"),
            opts => opts.EnableRetryOnFailure());
    }
}

3. 确保Program.cs中DI配置正确 #

确认在Web项目的Program.cs中正确调用扩展方法，且配置能被正确加载：

var builder = WebApplication.CreateBuilder(args);

// 调用你的扩展方法，确保configuration已加载所有配置源
builder.Services.ConfigureSqlContext(builder.Configuration);

// 其他服务注册...

var app = builder.Build();
// ...

4. Azure App Service连接字符串的正确配置与读取 #

方式一：使用Azure连接字符串面板

• 在Azure App Service的配置 > 连接字符串中添加名为defaultConnection的条目，类型选择SQL Server
• 代码中继续使用configuration.GetConnectionString("defaultConnection")读取，Azure会自动将该值注入到ConnectionStrings配置节点下

方式二：使用Azure环境变量

• 如果选择用环境变量（如你之前试的PeakedDbConn），需要在Azure的配置 > 应用程序设置中添加该变量
• 代码中需改用configuration["PeakedDbConn"]读取，而非GetConnectionString（后者专门读取ConnectionStrings节点）

注意：Azure的应用设置会自动覆盖本地配置，无需修改代码区分环境，.NET会自动按优先级加载。

5. 修正多项目下的设计时工厂（仅本地迁移用） #

设计时工厂是给EF Core CLI命令（如add-migration）用的，Azure部署时不会调用它。针对多项目场景，要指向Web项目的配置文件路径：

public class RepositoryContextFactory : IDesignTimeDbContextFactory<PeakedDbContext>
{
    public PeakedDbContext CreateDbContext(string[] args)
    {
        // 替换为你的Web项目名称，确保路径正确
        var webProjectPath = Path.Combine(Directory.GetCurrentDirectory(), "../YourWebProject");
        var configuration = new ConfigurationBuilder()
            .SetBasePath(webProjectPath)
            .AddJsonFile("appsettings.json")
            .Build();
            
        var optionsBuilder = new DbContextOptionsBuilder<PeakedDbContext>();
        optionsBuilder.UseSqlServer(
            configuration.GetConnectionString("defaultConnection"),
            opts => opts.EnableRetryOnFailure());
            
        // 设计时不需要ICurrentUserService，传null即可
        return new PeakedDbContext(optionsBuilder.Options, null);
    }
}

验证步骤 #

1. 本地测试：确保通过appsettings.json能正常连接数据库
2. Azure测试：部署后，查看App Service的日志流，确认没有连接字符串为null的错误
3. 排查配置：在Azure的配置 > 应用程序设置中点击"显示值"，确认配置的连接字符串/环境变量值正确

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