构建.NET+PostgreSQL Docker容器时遇Host can't be null错误求助

错误现象 #

执行Docker构建时抛出异常：

8.578 System.ArgumentException: Host can't be null

错误原因分析 #

1. 构建阶段无法访问PostgreSQL服务：Dockerfile的build阶段是独立于docker-compose网络的，此时db服务尚未启动，且构建环境无法解析db这个主机名，导致EF迁移命令无法连接数据库。
2. 构建阶段未注入有效连接字符串：构建过程中未传递正确的数据库连接环境变量，EF只能读取appsettings.json中的配置，但该配置里的Server=db在构建环境中无法被解析。

解决方案 #

方案一：分离EF迁移与镜像构建（推荐） #

将EF迁移操作从镜像构建流程中移除，改为本地执行或容器启动时执行，避免构建阶段依赖数据库服务。

1. 修改Dockerfile

移除构建阶段的EF迁移命令：

FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
WORKDIR /src
COPY ["file.csproj", "./"]
RUN dotnet restore "./file.csproj"
COPY . .
WORKDIR "/src/."
RUN dotnet build "file.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "file.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
# 替换为实际项目的DLL名称，例如EnrollApp.dll
ENTRYPOINT ["dotnet", "EnrollApp.dll"]

2. 本地执行EF迁移

• 先启动PostgreSQL服务：

  docker-compose up -d db
  

• 本地连接数据库（端口映射为5433），执行迁移命令：

  dotnet tool install --global dotnet-ef --version 7.0.3
  dotnet ef migrations add InitialCreate --project EnrollApp.csproj
  dotnet ef database update --connection "Server=localhost;Port=5433;Database=my_db;Username=postgres;Password=example"
  

• 最后构建并启动所有服务：

  docker-compose build && docker-compose up -d
  

方案二：构建阶段连接到docker-compose网络（复杂场景可选） #

通过传递构建参数和连接到现有网络，让构建阶段能访问db服务。

1. 修改docker-compose.yml

添加构建参数并指定网络：

version: '3.4'

networks:
  dev:
    driver: bridge
services:
 db:
   image: postgres
   environment:
     POSTGRES_USER: postgres
     POSTGRES_DB: my_db
     POSTGRES_PASSWORD: example
   ports:
      - 5433:5432
   restart: always
   networks:
      - dev
   volumes:
     - postgres-data:/var/lib/postgresql/data
 adminer:
   image: adminer
   restart: always
   ports:
     - 8080:8080
   networks:
     - dev
 app:
   image: docker.io/library/appdemo
   build:
     context: .
     dockerfile: ./Dockerfile
     args:
       - CONNECTION_STRING=User ID=postgres;Password=example;Server=db;Port=5432;Database=my_db;Pooling=true;
   environment:
      - ConnectionStrings__DefaultConnection=User ID=postgres;Password=example;Server=db;Port=5432;Database=my_db;Pooling=true;
      - ASPNETCORE_URLS=http://+:80
   ports:
     - 5000:80
   depends_on:
     - db
   networks:
      - dev
volumes:
 postgres-data:

2. 修改Dockerfile

接收构建参数并设置环境变量：

FROM mcr.microsoft.com/dotnet/aspnet:7.0 AS base
WORKDIR /app
EXPOSE 80
EXPOSE 443

FROM mcr.microsoft.com/dotnet/sdk:7.0 AS build
ARG CONNECTION_STRING
ENV ConnectionStrings__DefaultConnection=$CONNECTION_STRING
WORKDIR /src
COPY ["file.csproj", "./"]
RUN dotnet restore "./file.csproj"
COPY . .
RUN dotnet tool install --global dotnet-ef --version 7.0.3
# 需确保db服务已在dev网络中运行
RUN /root/.dotnet/tools/dotnet-ef migrations add InitialCreate --project EnrollApp.csproj -v
RUN /root/.dotnet/tools/dotnet-ef database update

WORKDIR "/src/."
RUN dotnet build "file.csproj" -c Release -o /app/build

FROM build AS publish
RUN dotnet publish "file.csproj" -c Release -o /app/publish

FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .
ENTRYPOINT ["dotnet", "EnrollApp.dll"]

3. 执行流程

# 先启动db服务
docker-compose up -d db
# 构建app镜像
docker-compose build app
# 启动所有服务
docker-compose up -d

额外注意事项 #

• 移除连接字符串中的Integrated Security=true，该配置对PostgreSQL无效，会造成解析干扰。
• depends_on仅保证服务启动顺序，不保证数据库完全就绪，可在应用启动逻辑中添加数据库连接重试机制，或为db服务添加健康检查。

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