Docker中ASP.NET配置PostgreSQL连接字符串（环境变量）报错排查

核心问题排查 #

你遇到的"host不能为null"大概率是连接字符串配置错误导致的连接失败，而非真的Host未读取。结合你的配置，重点检查以下几点：

1. 修正容器间通信的端口配置 #

Docker容器内部的PostgreSQL默认端口是5432，你的appsettings里用的是宿主机映射的5433，但容器之间通信不需要用宿主机端口，直接用容器内的5432即可。修改Docker Compose里的环境变量：

environment:
  - "ConnectionStrings__DbContext=User ID=postgres;Password=postgres;Host=app_db;Port=5432;Database=asp;Pooling=true;"

同时确认你的docker-compose.yml中PostgreSQL服务的端口映射正确（宿主机5433映射到容器5432）：

services:
  app_db:
    image: postgres:latest
    ports:
      - "5433:5432"
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
      POSTGRES_DB: asp

2. 确认Docker Compose服务关联 #

确保你的ASP.NET Core服务和app_db服务在同一个docker-compose.yml文件中，并且添加depends_on配置保证启动顺序：

services:
  your_app_service:
    build: .
    environment:
      - ConnectionStrings__DbContext=User ID=postgres;Password=postgres;Host=app_db;Port=5432;Database=asp;Pooling=true;
    depends_on:
      - app_db

这样Compose会自动将两个服务加入同一网络，ASP.NET Core容器可以通过app_db这个服务名访问PostgreSQL容器。

3. 验证配置是否被正确读取 #

在Program.cs中临时添加日志输出，确认加载的连接字符串是否来自环境变量：

var connString = builder.Configuration["ConnectionStrings:DbContext"];
Console.WriteLine($"当前使用的连接字符串: {connString}");
options.UseNpgsql(connString);

启动容器后查看控制台日志，如果输出的还是appsettings里的localhost:5433，说明环境变量未正确传递，检查：

• 环境变量键名是否正确：必须用双下划线__代替配置层级的冒号，即ConnectionStrings__DbContext
• Docker Compose中服务的环境变量配置是否有语法错误（比如引号、分号是否正确）

4. 更健壮的配置读取方式 #

改用GetConnectionString方法读取，避免字符串键名出错：

options.UseNpgsql(builder.Configuration.GetConnectionString("DbContext"));

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