ASP.NET Core 7环境变量无法覆盖appsettings.json问题求助

1. 修正环境变量命名格式 #

ASP.NET Core 对配置键的环境变量映射要求双下划线替代冒号，比如appsettings.json中ConnectionStrings:MongoDB对应的环境变量必须写成ConnectionStrings__MongoDB（双下划线，而非冒号）。

docker-compose.override.yml中需按此格式配置：

services:
  your-api-service:
    environment:
      - ConnectionStrings__MongoDB=mongodb://mongodb:27017/YourTargetDb

注意：冒号在环境变量中会被解析为路径分隔符，必须用双下划线转义，这是ASP.NET Core 3.1+的统一规则，可能你之前的写法不符合规范导致未生效。

2. 确认配置加载优先级 #

ASP.NET Core 7的配置优先级从高到低为：

• 命令行参数
• 环境变量
• appsettings.{Environment}.json
• appsettings.json

检查是否存在更高优先级的配置覆盖了环境变量，比如启动命令中传入了连接字符串参数，或者appsettings.Development.json/appsettings.Production.json中的配置未被环境变量覆盖（需确保环境变量配置在docker-compose中正确注入）。

3. 验证环境变量是否传入容器 #

进入容器内部，确认环境变量是否成功注入：

# 替换为你的容器ID或名称
docker exec -it your-api-container bash
# 查看目标环境变量
echo $ConnectionStrings__MongoDB

如果输出为空，说明docker-compose的yaml文件存在格式错误（比如缩进用了tab而非空格、语法错误），需检查配置文件的格式规范性。

4. 检查Program.cs的配置加载逻辑 #

ASP.NET Core 7使用顶级语句的默认Program.cs已经按正确顺序加载配置，但如果自定义了配置源，需确保AddEnvironmentVariables()在AddJsonFile()之后调用，保证环境变量优先级高于json配置：

var builder = WebApplication.CreateBuilder(args);

// 若自定义配置源，需保证环境变量加载在json之后
builder.Configuration
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddEnvironmentVariables(); // 此语句需在AddJsonFile之后

默认的CreateBuilder已处理好优先级，若你修改过配置加载流程，需确认顺序是否正确。

5. 匹配环境名称配置 #

检查docker-compose中是否正确设置了ASPNETCORE_ENVIRONMENT，确保加载的环境配置文件不会干扰环境变量的覆盖：

environment:
  - ASPNETCORE_ENVIRONMENT=Development

即使appsettings.{Environment}.json中有连接字符串配置，环境变量仍拥有更高优先级，除非配置源顺序被错误修改。

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