.NET 6.0中Azure连接字符串无法覆盖appsettings.json问题求助

首先明确一个关键事实：Azure App Service配置的连接字符串不会修改部署到wwwroot的appsettings.json文件，你看到的文件内容和本地一致是正常现象。Azure的配置是通过环境变量注入到应用运行时的配置系统中，优先级高于本地配置，只要配置正确，应用运行时会自动使用Azure的连接字符串。

以下是确保生效的具体步骤：

1. 确认Azure连接字符串的配置类型 #

在Azure App Service的「配置」→「连接字符串」中，确保你的SqlConnection对应的类型选择为SQL Server（如果是其他数据库类型选对应项，自定义类型也可生效，但匹配类型更符合规范）。

2. 确保.NET 6配置加载逻辑正确 #

.NET 6的WebApplication.CreateBuilder(args)默认已经包含了Azure App Service的配置源，会自动加载Azure的连接字符串并覆盖本地配置。你的DbContext配置代码：

services.AddDbContext<MyContext>(
    options => options.UseSqlServer(Configuration.GetConnectionString("SqlConnection")));

是正确的，只要配置源加载正常，Configuration.GetConnectionString会优先获取Azure注入的值。

如果你的Program.cs自定义了配置构建逻辑，要确保没有移除Azure相关的配置源，默认创建的项目已包含如下基础逻辑：

var builder = WebApplication.CreateBuilder(args);
// 自动包含Azure App Service配置、环境变量等，无需额外添加

3. 验证运行时的配置值 #

不要通过查看appsettings.json文件判断配置是否生效，而是通过以下方式验证：

• 在Program.cs中添加日志输出：

  var connectionString = builder.Configuration.GetConnectionString("SqlConnection");
  builder.Logging.AddConsole();
  var logger = builder.Services.BuildServiceProvider().GetRequiredService<ILogger<Program>>();
  logger.LogInformation("当前使用的连接字符串：{ConnectionString}", connectionString);
  

• 或者添加一个测试接口返回连接字符串（上线前记得移除）：

  app.MapGet("/get-connection", (IConfiguration config) => 
      config.GetConnectionString("SqlConnection"));
  

部署后访问接口或查看应用日志，确认使用的是Azure配置的连接字符串。

4. 排查常见问题 #

• 名称匹配问题：Azure中的连接字符串名称必须和本地SqlConnection完全一致（.NET配置默认大小写不敏感，但建议完全匹配避免问题）。
• 未重启应用：修改Azure配置后，需要重启App Service才能让新配置生效。
• 配置源优先级问题：如果手动调整了配置源的加载顺序，要确保Azure相关的配置源（环境变量、Azure App Configuration）在本地appsettings之后加载，这样才能覆盖本地值。

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