EF Core 连接 PostgreSQL 需三步:安装 Npgsql.EntityFrameworkCore.PostgreSQL、Microsoft.EntityFrameworkCore.Tools 和 Microsoft.EntityFrameworkCore.Design 三个 NuGet 包;在 appsettings.json 中配置 PostgreSQL 连接字符串;定义继承 DbContext 的类并在 Program.cs 中通过 AddDbContext 注册,最后执行迁移命令生成数据库。
EF Core 连接 PostgreSQL 不难,关键是三步到位:装对包、写对连接字符串、配好 DbContext。下面直接说清楚怎么做,不绕弯。
缺一不可,建议用 dotnet CLI 命令安装(兼容性更好):
dotnet ef migrations add 等)执行命令:
dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL
dotnet add package Microsoft.EntityFrameworkCore.Tools
dotnet add package Microsoft.EntityFrameworkCore.Design
推荐放在 appsettings.json 里,结构清晰又方便换环境:
"ConnectionStrings": {
"PgConnection": "Host=localhost;Port=5432;Database=myappdb;Username=postgres;Password=your_password"
}
注意点:
dotnet user-secrets 替代明文(开发阶段)Host 改成服务名或 IP,确保网络通(常见超时错误多因连不上)先写一个继承 DbContext 的类:
public class AppDbContext : DbContext
{
public AppDbContext(DbContextOptions options) : base(options) { }
public DbSetProducts { get; set; }
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity().ToTable("products"); // 映射到小写表名
}
}
然后在 Program.cs(.NET 6+)中注册:
builder.Services.AddDbContext(options =>
options.UseNpgsql(builder.Configuration.GetConnectionString("PgConnection")));
这样后续控制器或服务里直接注入 AppDbContext 就能用了。
确保项目是启动项目,再执行:
dotnet ef migrations add InitialCreate
dotnet ef database update
成功后,PostgreSQL 里就会自动建好 products 表(含主键、时间戳等 EF 默认字段)。
基本上就这些。不复杂但容易忽略细节,比如包漏装、连接串端口写错、Docker 网络没打通——遇到连不上,优先查这三项。