EF Core 连接 MySQL 数据库核心三步:安装 Pomelo 驱动及 EF 设计工具包、配置含 utf8mb4 和显式端口的连接字符串、注册 DbContext 并启用自动版本检测。

EF Core 连接 MySQL 数据库,核心就三步:装对驱动、配好连接字符串、注册 DbContext。用 Pomelo 提供程序是当前最主流、兼容性最好、文档最全的选择(官方 MySQL EF 包已基本停止维护)。
安装 Pomelo 驱动和基础包
在项目中执行以下命令(.NET 6/7/8/9 均适用):
- dotnet add package Pomelo.EntityFrameworkCore.MySql —— 必装,MySQL 的 EF Core 提供程序
-
dotnet add package Microsoft.EntityFrameworkCore.Design —— 支持迁移命令(
dotnet ef) - dotnet add package Microsoft.EntityFrameworkCore.Tools —— 设计时工具(VS 中的包管理器控制台也依赖它)
不需要再装 MySql.Data 或 MySql.Data.EntityFrameworkCore,Pomelo 已内置完整实现,且更活跃、适配新版 MySQL(如 8.0+ 的 caching_sha2_password 认证)。
配置连接字符串(推荐 appsettings.json)
在 appsettings.json 的 ConnectionStrings 节点下添加:
"ConnectionStrings": {
"MySqlDb": "server=localhost;port=3306;database=myappdb;user=root;password=123456;CharSet=utf8mb4;"
}
关键细节:
-
用
utf8mb4替代utf8:支持 emoji 和四字节 Unicode 字符 - 显式写
port=3306:避免默认端口误判;若改过端口(如腾讯云/阿里云 RDS),务必填对 - 密码含特殊字符(如
@、/)时,需 URL 编码(例如pass@123→pass%40123)
定义 DbContext 并注册服务
新建上下文类,比如 AppDbContext.cs:
public class AppDbContext : DbContext
{
public AppDbContext(DbContextOptions options) : base(options) { }
public DbSet Users { get; set; }
}
在 Program.cs(.NET 6+)中注册:
var builder = WebApplication.CreateBuilder(args);
var connectionString = builder.Configuration.GetConnectionString("MySqlDb");
builder.Services.AddDbContext(options =>
options.UseMySql(connectionString, ServerVersion.AutoDetect(connectionString)));
注意:ServerVersion.AutoDetect 会自动识别 MySQL 版本(5.7 / 8.0 / 8.4),无需手动指定;如需精确控制(如用 8.0.33 的特性),可改为 new ServerVersion(new Version(8, 0, 33), ServerType.MySql)。
生成数据库表(Code First)
实体类写好后,运行两条命令即可建库建表:
- dotnet ef migrations add InitialCreate
- dotnet ef database update
首次运行会自动创建数据库(只要连接字符串里指定的库名不存在,Pomelo 默认会尝试创建);若提示权限不足,请确认 MySQL 用户有 CREATE DATABASE 权限。
基本上就这些。不复杂但容易忽略的是字符集、端口、认证方式这三点——连不上时优先检查它们。










