Kubernetes YAML部署.NET6时覆盖MSSQL连接字符串不生效

你遇到的是.NET配置体系和K8s配置注入协同时的高频问题，其余配置项生效仅连接字符串不生效，按出现概率从高到低排查以下点即可：

• 优先排查代码里的DbContext注册逻辑
  90%的同类问题根源都在这里：不少开发者在注册EF Core DbContext时图省事，直接在UseSqlServer/UseNpgsql等方法里硬编码了连接字符串，或是调用GetConnectionString时传入的键名和配置不匹配（比如传了Default而非DefaultConnection），这种情况下无论上层怎么改配置覆盖，最终代码用的都是硬编码值。
  正确的注册写法参考：

  builder.Services.AddDbContext<TransactionDbContext>(options =>
      // 明确从配置节点读取连接字符串，键名和appsettings.json、环境变量里的键完全匹配
      options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection"))
  );
  

• 排查配置提供程序的加载顺序
  .NET配置系统的核心规则是：后加载的配置源会覆盖先加载的同键配置。默认WebApplication.CreateBuilder生成的模板，配置加载顺序为appsettings.json → appsettings.{Environment}.json → 开发环境用户机密 → 环境变量 → 命令行参数，本来环境变量优先级高于本地json文件。
  如果你手动在Program.cs里追加配置代码时顺序写反，比如先调用AddEnvironmentVariables()加载环境变量，之后又调用AddJsonFile重新加载appsettings.json，就会出现json文件反向覆盖环境变量值的问题。
  错误写法示例：

  builder.Configuration.AddEnvironmentVariables();
  // 后加载的json文件会覆盖之前加载的环境变量值
  builder.Configuration.AddJsonFile("appsettings.json", optional: true, reloadOnChange: true);
  

  调整顺序，把所有json文件的加载逻辑放到AddEnvironmentVariables之前即可修复。另外如果你额外接入了Azure Key Vault、独立配置中心等存储连接字符串的源，只要这类源在环境变量之后加载，同样会覆盖环境变量里的连接字符串。
• 排查K8s侧的环境变量注入是否实际生效
  你贴的配置里有两个容易踩的注入坑：
  1. 你的ConfigMap部署在dev命名空间，如果业务工作负载（Deployment/StatefulSet）没有部署在同一个dev命名空间，且configMapKeyRef没有显式指定ConfigMap所在命名空间，K8s会默认去工作负载所在命名空间查找ConfigMap，找不到就会注入失败。如果配置里加了optional: true，Pod不会报启动错误，只会跳过这个环境变量注入，应用就会自动回退读取appsettings.json里的默认连接字符串。
  2. 你贴的YAML中valueFrom下的configMapKeyRef缩进为8空格，YAML本身对缩进空格数不敏感但要求层级对齐，如果实际部署的YAML里configMapKeyRef层级写错、或是引用的键名不匹配（比如把database_uri写成database-uri），也会导致注入失败。
     最快的排查方式：进入运行中的容器执行printenv | grep ConnectionStrings命令，看输出的ConnectionStrings__DefaultConnection值是不是ConfigMap中配置的目标值，如果没有对应输出，就说明是K8s注入环节的问题。
• 排查Azure CI/CD流水线的自动替换逻辑
  Azure DevOps自带的K8s部署任务、文件转换任务默认开启JSON变量替换功能，这个功能对ConnectionStrings节点有特殊匹配规则：如果流水线变量中定义了和连接字符串同名的变量，会在构建/部署阶段直接修改appsettings.json里的对应值；如果流水线里误配置了同名的默认值/空值，就会出现环境变量注入成功，但被提前修改的json文件值覆盖的情况。你可以直接解压构建产物/进入容器查看appsettings.json里的DefaultConnection值，如果已经被改成了默认值，关掉部署任务里的「JSON变量替换」选项即可。

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