Docker Compose环境变量无法覆盖.NET Core应用appsettings.json问题

问题描述 #

通过Docker Compose部署.NET Core Web应用时，已在docker-compose.yml中配置ConnectionStrings__DefaultConnection环境变量，但应用仍读取appsettings.Development.json中指向localhost的连接字符串，导致连接Docker容器内的PostgreSQL数据库失败，报错：

---> System.Net.Sockets.SocketException (99): Cannot assign requested address [::1]:5432

相关配置文件 #

Dockerfile

FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
WORKDIR /app
EXPOSE 80

# Copy the solution file
COPY test-docker.sln ./
COPY test-docker/test-docker.csproj test-docker/

RUN dotnet restore test-docker.sln

COPY . .

# Build and publish the application
WORKDIR /app/test-docker
RUN dotnet publish -c Release -o /app/out

# Stage 2: Runtime Stage
FROM mcr.microsoft.com/dotnet/aspnet:8.0
WORKDIR /app
COPY --from=build /app/out .
ENTRYPOINT ["dotnet", "test-docker.dll"]

docker-compose.yml

services:
  db:
    image: postgres:15
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydatabase
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data

  webapp:
    image: test-docker-app
    build:
      context: .
      dockerfile: test-docker/Dockerfile
    environment:
      - ASPNETCORE_ENVIRONMENT=Development
      - ASPNETCORE_URLS=http://+:80
      - ConnectionStrings__DefaultConnection=Host=db;Port=5432;Database=mydatabase;Username=myuser;Password=mypassword
    depends_on:
      - db
    ports:
      - "8081:80"

volumes:
  pgdata:

appsettings.Development.json

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Port=5432;Database=mydatabase;Username=myuser;Password=mypassword"
  }
}

解决方案 #

1. 确认配置加载顺序 #

.NET Core的配置优先级规则是：环境变量 > 环境特定appsettings > 通用appsettings，需确保代码中环境变量加载逻辑在配置文件之后。检查Program.cs中的配置加载代码：

var builder = WebApplication.CreateBuilder(args);

// 加载基础配置文件
builder.Configuration
    .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
    .AddJsonFile($"appsettings.{builder.Environment.EnvironmentName}.json", optional: true, reloadOnChange: true)
    // 关键：确保环境变量在配置文件之后加载，实现覆盖
    .AddEnvironmentVariables();

// 后续服务注册代码...

默认.NET 8模板已包含该逻辑，若自定义了配置加载流程，需调整顺序。

2. 检查环境变量命名与传递 #

• Docker环境中环境变量区分大小写，确保ConnectionStrings__DefaultConnection的大小写与配置节点完全匹配，不可写成小写形式
• 验证环境变量是否传入容器：

  docker exec -it <webapp容器名称> printenv ConnectionStrings__DefaultConnection
  

  若输出正确的Host=db;...连接字符串，说明变量已传递；若为空，检查docker-compose.yml的环境变量语法是否有误。

3. 添加数据库健康检查 #

depends_on仅保证容器启动顺序，不确保PostgreSQL服务就绪。修改docker-compose.yml为db服务添加健康检查：

services:
  db:
    # 原有配置...
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U myuser -d mydatabase"]
      interval: 5s
      timeout: 5s
      retries: 5
  webapp:
    # 原有配置...
    depends_on:
      db:
        condition: service_healthy

这样Web应用会等待数据库健康检查通过后再启动，避免连接时数据库未就绪。

4. 调试配置加载结果 #

在Program.cs中添加日志输出，确认加载的连接字符串：

var connString = builder.Configuration.GetConnectionString("DefaultConnection");
builder.Logging.AddConsole();
var logger = LoggerFactory.Create(c => c.AddConsole()).CreateLogger("Program");
logger.LogInformation("当前加载的连接字符串: {ConnString}", connString);

启动容器后查看日志，确认是否使用了环境变量中的值。

验证步骤 #

1. 清理旧容器与卷：

   docker-compose down -v
   

2. 重新构建并启动：

   docker-compose build && docker-compose up
   

3. 查看Web应用日志，确认连接字符串已更新为Host=db的版本。

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