.NET 6容器无法连接PostgreSQL Docker容器问题求助

1. 修复[::1]:5432连接失败问题 #

• 修正数据库连接字符串：Docker容器间通信不能用localhost或[::1]，必须使用docker-compose中PostgreSQL服务的名称作为主机地址。比如你的compose文件里PostgreSQL服务名为postgres，则AppSettings中的连接字符串应改为：

  "ConnectionStrings": {
    "DefaultConnection": "Host=postgres;Port=5432;Database=mail;Username=your_user;Password=your_password;"
  }
  

• 确认容器网络归属：只要.NET应用和PostgreSQL服务在同一个docker-compose.yaml文件中，默认会被分配到同一专属网络，无需额外配置；如果是单独启动的容器，需手动将它们加入同一网络。

2. 解决PostgreSQL未生成表的问题 #

• 开启自动迁移逻辑：在Program.cs中添加启动时自动应用迁移的代码，确保数据库表结构被创建：

  var app = builder.Build();
  
  // 启动时执行数据库迁移
  using (var scope = app.Services.CreateScope())
  {
      var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
      dbContext.Database.Migrate();
  }
  
  // 后续中间件配置
  app.UseSwagger();
  app.UseSwaggerUI();
  // ...其他配置
  

• 验证DbContext注册正确性：确认Program.cs中已正确使用Npgsql注册DbContext：

  builder.Services.AddDbContext<YourDbContext>(options =>
      options.UseNpgsql(builder.Configuration.GetConnectionString("DefaultConnection")));
  

• 确保迁移文件已包含在镜像中：本地开发时需先执行dotnet ef migrations add InitialCreate生成迁移文件，且Dockerfile要确保复制了Migrations文件夹（默认COPY . .会包含，若有忽略规则需检查.gitignore或.dockerignore）。
• 容器启动前等待PostgreSQL就绪：depends_on仅保证容器启动顺序，不确保数据库服务就绪。可在应用中添加连接重试逻辑，或在docker-compose的应用命令中加入等待脚本：

  services:
    your-app:
      build: .
      command: sh -c "until pg_isready -h postgres -p 5432; do sleep 2; done; dotnet ef database update && dotnet YourApp.dll"
      depends_on:
        - postgres
    postgres:
      image: postgres:latest
      environment:
        POSTGRES_USER: your_user
        POSTGRES_PASSWORD: your_password
        POSTGRES_DB: mail
  

3. 额外排查步骤 #

• 检查PostgreSQL环境变量：确认compose中POSTGRES_DB值为mail，与连接字符串中的数据库名一致，确保容器启动时自动创建该库。
• 查看容器日志定位细节：通过日志获取更精准的错误信息：

  docker logs <your-app-container-id>
  docker logs <postgres-container-id>
  

• 验证Dockerfile构建完整性：确保Dockerfile正确复制项目文件并完成发布，示例配置：

  FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
  WORKDIR /app
  EXPOSE 80
  
  FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
  WORKDIR /src
  COPY ["YourApp.csproj", "."]
  RUN dotnet restore
  COPY . .
  RUN dotnet build -c Release -o /app/build
  
  FROM build AS publish
  RUN dotnet publish -c Release -o /app/publish
  
  FROM base AS final
  WORKDIR /app
  COPY --from=publish /app/publish .
  ENTRYPOINT ["dotnet", "YourApp.dll"]
  

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