.NET 8+EF无法连接Docker Compose部署的PostgreSQL数据库求助

核心排查步骤 #

1. 用服务名作为数据库主机地址 #

Docker Compose会自动给所有服务创建共享网络，容器之间直接用服务名称就能访问，别用localhost、127.0.0.1或者宿主机IP。比如你的PostgreSQL服务在docker-compose.yml里叫postgres，连接字符串就得这么写：

Host=postgres;Database=你的数据库名;Username=postgres;Password=你的密码;Port=5432

2. 等数据库就绪再启动.NET应用 #

PostgreSQL容器启动时会先跑初始化流程，日志里的database system is shut down是正常步骤，只有出现database system is ready to accept connections才代表数据库能用。给.NET服务加个依赖检查，确保数据库就绪后再启动：

services:
  dotnet-app:
    build: .
    depends_on:
      postgres:
        condition: service_healthy
  postgres:
    image: postgres:16
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: 你的密码
      POSTGRES_DB: 你的数据库名
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5

3. 核对连接字符串与数据库配置 #

确保连接字符串里的用户名、密码、数据库名，和docker-compose.yml中PostgreSQL的POSTGRES_USER、POSTGRES_PASSWORD、POSTGRES_DB完全一致，大小写都不能错。

4. 单独启动数据库时的.NET连接问题 #

之前单独跑数据库容器，DBeaver能连但.NET不行，要是.NET是本地运行（没在容器里），连接字符串得用宿主机的IP，或者Docker Desktop环境下用host.docker.internal，不能直接用容器IP或者localhost。

5. 测试容器间网络连通性 #

要是以上都没用，进.NET容器里测下能不能通数据库：

# 进入你的.NET容器
docker exec -it 你的dotnet容器名 sh
# 装telnet（Alpine镜像的话）
apk add telnet
# 测试数据库端口
telnet postgres 5432

如果连不上，检查Docker Compose有没有自定义网络导致两个服务不在同一网络里，默认Compose会把所有服务放同一个网络，不用额外配置。

常见坑点总结 #

• 容器间连接必须用服务名，别乱填主机地址
• 数据库没就绪就启动.NET，肯定连不上，加健康检查依赖解决
• 连接字符串和数据库环境变量不匹配，直接报错
• 本地运行.NET连容器数据库，要用宿主机IP或者host.docker.internal

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