EF Core 与 MySQL：迁移和关系配置详解

陶志發表於 2025-9-15 23:57:00

EF Core 与 MySQL：迁移和关系配置详解

<div class="dad65929">
<div class="_4f9bf79 d7dc56a8 _43c05b5">
<div class="ds-message _63c77b1">
<div class="ds-markdown">
本文将详细讲解EF Core与MySQL的关系配置和迁移，包括一对一、一对多、多对多关系的配置，使用Fluent API进行关系配置，处理迁移中的常见问题，以及数据种子的方法。
<h2>1. EF Core 中的关系类型</h2>
Entity Framework Core 支持三种主要的关系类型：
<h3>一对一关系 (One-to-One)</h3>
一个实体实例只与另一个实体实例相关联。例如：一个用户有一个用户资料。
<div class="md-code-block md-code-block-light">
<div class="cnblogs_code">
<pre>public class User
{
public int Id { get; set; }
public string Username { get; set; }
public UserProfile Profile { get; set; } // 导航属性
}

public class UserProfile
{
public int Id { get; set; }
public string FullName { get; set; }
public DateTime DateOfBirth { get; set; }
public int UserId { get; set; } // 外键
public User User { get; set; } // 导航属性
}</pre>
</div>
</div>
<h3>一对多关系 (One-to-Many)</h3>
一个实体实例与多个另一个实体实例相关联。例如：一个博客有多篇文章。
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>public class Blog
{
public int Id { get; set; }
public string Title { get; set; }
public List<Post> Posts { get; set; } // 导航属性
}

public class Post
{
public int Id { get; set; }
public string Title { get; set; }
public string Content { get; set; }
public int BlogId { get; set; } // 外键
public Blog Blog { get; set; } // 导航属性
}</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<h3>多对多关系 (Many-to-Many)</h3>
多个实体实例与多个另一个实体实例相关联。例如：一个学生可以选多门课程，一门课程可以有多个学生。
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>public class Student
{
public int Id { get; set; }
public string Name { get; set; }
public List<Course> Courses { get; set; } // 导航属性
}

public class Course
{
public int Id { get; set; }
public string Title { get; set; }
public List<Student> Students { get; set; } // 导航属性
}

// 连接实体（EF Core 5.0+ 可以隐式处理，但显式定义更灵活）
public class StudentCourse
{
public int StudentId { get; set; }
public Student Student { get; set; }
public int CourseId { get; set; }
public Course Course { get; set; }
public DateTime EnrollmentDate { get; set; }
}</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<h2>2. 使用 Fluent API 配置关系</h2>
Fluent API 提供了更精细的控制方式来配置关系：
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>protected override void OnModelCreating(ModelBuilder modelBuilder)
{
// 一对一关系配置
modelBuilder.Entity<User>()
 .HasOne(u => u.Profile)
 .WithOne(up => up.User)
 .HasForeignKey<UserProfile>(up => up.UserId);

// 一对多关系配置
modelBuilder.Entity<Blog>()
 .HasMany(b => b.Posts)
 .WithOne(p => p.Blog)
 .HasForeignKey(p => p.BlogId)
 .OnDelete(DeleteBehavior.Cascade); // 级联删除

// 多对多关系配置 (EF Core 5.0+)
modelBuilder.Entity<Student>()
 .HasMany(s => s.Courses)
 .WithMany(c => c.Students)
 .UsingEntity<StudentCourse>(
 j => j.HasOne(sc => sc.Course).WithMany().HasForeignKey(sc => sc.CourseId),
 j => j.HasOne(sc => sc.Student).WithMany().HasForeignKey(sc => sc.StudentId),
 j =>
 {
 j.HasKey(sc => new { sc.StudentId, sc.CourseId });
 j.Property(sc => sc.EnrollmentDate).HasDefaultValueSql("CURRENT_TIMESTAMP");
 });

// 配置索引
modelBuilder.Entity<Post>()
 .HasIndex(p => p.Title)
 .IsUnique();

// 配置表名和列名
modelBuilder.Entity<User>()
 .ToTable("Users")
 .Property(u => u.Username)
 .HasColumnName("user_name")
 .HasMaxLength(50);
}</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<div>
<h2>3、EF Core 配置字段长度或精度</h2>
</div>
<div class="item-container_62BMH">
<div class="content-box_1t3WR">
<div class="markdown-wrapper_4CcPR">
<div class="dqa-markdown_5emil ">
<div class="markdown_1jK8o ">
在Entity Framework Core (EF Core)中，配置字段长度或精度涉及到如何在模型中指定数据库列的属性。EF Core通过数据注解（Data Annotations）或Fluent API提供了多种方式来实现这一需求。下面将分别介绍如何使用这两种方法。
<h3>使用数据注解</h3>
在模型类中，你可以使用如<code class="dqa-code-span"></code>、<code class="dqa-code-span"></code>等属性来指定字段的长度或精度。
<ul>
<li>示例：使用<code class="dqa-code-span"></code></li>
</ul>
<div class="cnblogs_code">
<pre>using System.ComponentModel.DataAnnotations;

public class Product
{
public int Id { get; set; }

public string Name { get; set; }
}</pre>
</div>
<ul>
<li>
示例：使用<code class="dqa-code-span"> </code>

</li>

</ul>
<div class="code-header">
<div class="cnblogs_code">
<pre>using System.ComponentModel.DataAnnotations.Schema;

public class Product
{
　　public int Id { get; set; }

　　
　　public string Name { get; set; }
}</pre>
</div>
</div>
<h3>使用Fluent API</h3>
在DbContext的<code class="dqa-code-span">OnModelCreating</code>方法中，你可以使用Fluent API来配置字段的长度或精度。
<ul>
<li>示例：使用Fluent API配置字段长度</li>
</ul>
<div class="code-header">
<div class="cnblogs_code">
<pre>protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Product>(entity =>
{
 entity.Property(e => e.Name)
 .HasMaxLength(100);
});
}</pre>
</div>
</div>
<ul>
<li>示例：使用Fluent API指定列类型（包括精度和长度） </li>
</ul>
<div class="code-header">
<div class="cnblogs_code">
<pre>protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Product>(entity =>
{
 entity.Property(e => e.Price)
 .HasColumnType("decimal(18,2)"); // 例如，设置价格字段为decimal类型，总共18位，其中2位是小数部分 　　　　　　　//.HasPrecision(18, 2); // 确保同时使用HasPrecision来指定精度和长度
 });
}</pre>
</div>
</div>
<h3>注意事项</h3>
<ul>
<li>
<div class="dqa-li-inner">
数据类型映射：确保你指定的数据类型与数据库中的类型兼容。例如，使用<code class="dqa-code-span">decimal(18,2)</code>时，确保数据库支持这种类型。对于不支持的类型，如某些NoSQL数据库，可能需要自定义存储方式。
</div>
</li>
<li>
<div class="dqa-li-inner">
迁移：当你修改了模型并希望更新数据库时，确保运行了迁移命令（如<code class="dqa-code-span">Add-Migration</code>和<code class="dqa-code-span">Update-Database</code>）。EF Core会根据模型中的配置自动生成或更新数据库表结构。
</div>
</li>
<li>
<div class="dqa-li-inner">
性能和设计：在设计数据库和模型时，考虑到性能和设计需求。例如，对于非常大的文本字段，使用<code class="dqa-code-span">TEXT</code>类型而非<code class="dqa-code-span">VARCHAR(N)</code>可以更高效地存储大量文本数据。
</div>
</li>
</ul>
通过以上方法，你可以灵活地配置EF Core中的字段长度或精度，以适应不同的应用需求。
</div>
</div>
</div>
</div>
</div>
<h2>4. 处理迁移中的常见问题</h2>
<h3>创建和应用迁移</h3>
<div class="cnblogs_code">
<pre># 创建迁移
dotnet ef migrations add AddRelationships

# 应用迁移
dotnet ef database update

# 回滚迁移
dotnet ef database update PreviousMigrationName

# 删除最后一次迁移
dotnet ef migrations remove</pre>
</div>
<h3>解决迁移冲突</h3>
当多个开发人员同时创建迁移时，可能会产生冲突。解决方法：
<ol start="1">
<li>
协调团队成员，确保一次只有一个人创建迁移
</li>
<li>
使用 <code>dotnet ef migrations script</code> 生成SQL脚本，手动合并更改
</li>
<li>
删除冲突的迁移，重新创建
</li>
</ol>
<h3>处理模型更改后的迁移</h3>
当模型更改后，EF Core 可能无法自动检测所有更改。解决方法：
<ol start="1">
<li>
仔细检查生成的迁移代码
</li>
<li>
手动修改迁移文件以包含所有必要的更改
</li>
<li>
使用 <code>dotnet ef migrations add</code> 创建新的迁移
</li>
</ol>
<h3>处理外键约束问题</h3>
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>// 在迁移中处理外键约束
migrationBuilder.AddForeignKey(
name: "FK_Posts_Blogs_BlogId",
table: "Posts",
column: "BlogId",
principalTable: "Blogs",
principalColumn: "Id",
onDelete: ReferentialAction.Cascade);</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<h3>处理MySQL特定的迁移问题</h3>
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>// 在迁移中处理MySQL特定配置
migrationBuilder.AlterColumn<string>(
name: "Title",
table: "Posts",
type: "varchar(255)",
maxLength: 255,
nullable: false,
collation: "utf8mb4_unicode_ci",
oldClrType: typeof(string),
oldType: "longtext",
oldNullable: false)
.Annotation("MySql:CharSet", "utf8mb4");</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<h2>5. 数据种子 (Seed Data)</h2>
<h3>在迁移中配置种子数据</h3>
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>// 在迁移的Up方法中添加种子数据
protected override void Up(MigrationBuilder migrationBuilder)
{
migrationBuilder.InsertData(
 table: "Blogs",
 columns: new[] { "Id", "Title" },
 values: new object[] { 1, "Default Blog" });
}

// 在迁移的Down方法中移除种子数据
protected override void Down(MigrationBuilder migrationBuilder)
{
migrationBuilder.DeleteData(
 table: "Blogs",
 keyColumn: "Id",
 keyValue: 1);
}</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<h3>在DbContext中配置种子数据</h3>
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Blog>().HasData(
 new Blog { Id = 1, Title = "Default Blog" },
 new Blog { Id = 2, Title = "Secondary Blog" }
);

modelBuilder.Entity<Post>().HasData(
 new Post { Id = 1, Title = "First Post", Content = "Hello World", BlogId = 1 },
 new Post { Id = 2, Title = "Second Post", Content = "EF Core is awesome", BlogId = 1 }
);
}</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<h3>使用自定义初始化逻辑</h3>
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>public static class DbInitializer
{
public static void Initialize(ApplicationDbContext context)
{
 // 确保数据库已创建
 context.Database.EnsureCreated();

 // 检查是否已有数据
 if (context.Blogs.Any())
 {
 return; // 数据库已经 seeded
 }

 // 添加初始数据
 var blogs = new Blog[]
 {
 new Blog{Title="Technology Blog"},
 new Blog{Title="Food Blog"}
 };

 foreach (var blog in blogs)
 {
 context.Blogs.Add(blog);
 }
 context.SaveChanges();

 var posts = new Post[]
 {
 new Post{Title="Introduction to EF Core", Content="...", BlogId=1},
 new Post{Title="Best Pizza Recipe", Content="...", BlogId=2}
 };

 foreach (var post in posts)
 {
 context.Posts.Add(post);
 }
 context.SaveChanges();
}
}</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<h3>在应用程序启动时调用初始化</h3>
<div class="md-code-block md-code-block-light">
<div class="cnblogs_code">
<pre>// 在Program.cs或Startup.cs中
public static void Main(string[] args)
{
var host = CreateHostBuilder(args).Build();

using (var scope = host.Services.CreateScope())
{
 var services = scope.ServiceProvider;
 try
 {
 var context = services.GetRequiredService<ApplicationDbContext>();
 DbInitializer.Initialize(context);
 }
 catch (Exception ex)
 {
 var logger = services.GetRequiredService<ILogger<Program>>();
 logger.LogError(ex, "An error occurred while seeding the database.");
 }
}

host.Run();
}</pre>
</div>
</div>
<h2>6. 处理复杂场景</h2>
<h3>条件种子数据</h3>
<div class="md-code-block md-code-block-light">
<div class="md-code-block-banner-wrap">
<div class="md-code-block-banner md-code-block-banner-lite">
<div class="_121d384">
<div class="d2a24f03">
<div class="cnblogs_code">
<pre>public static void Initialize(ApplicationDbContext context)
{
// 只在开发环境中添加测试数据
if (Environment.GetEnvironmentVariable("ASPNETCORE_ENVIRONMENT") == "Development")
{
 if (!context.Blogs.Any())
 {
 context.Blogs.AddRange(
 new Blog { Title = "Test Blog 1" },
 new Blog { Title = "Test Blog 2" }
 );
 context.SaveChanges();
 }
}

// 在所有环境中添加必要的基础数据
if (!context.Roles.Any())
{
 context.Roles.AddRange(
 new Role { Name = "Administrator" },
 new Role { Name = "User" }
 );
 context.SaveChanges();
}
}</pre>
</div>
</div>
</div>
</div>
</div>
</div>
<h3>使用JSON文件存储种子数据</h3>
<div class="md-code-block md-code-block-light">
<div class="cnblogs_code">
<pre>public static void Initialize(ApplicationDbContext context)
{
if (!context.Blogs.Any())
{
 var seedDataPath = Path.Combine(Directory.GetCurrentDirectory(), "SeedData");
 var blogsJson = File.ReadAllText(Path.Combine(seedDataPath, "blogs.json"));
 var blogs = JsonSerializer.Deserialize<List<Blog>>(blogsJson);

 context.Blogs.AddRange(blogs);
 context.SaveChanges();
}
}</pre>
</div>
</div>
<h2>总结</h2>
本文详细介绍了EF Core与MySQL中的关系配置、迁移处理和种子数据管理。关键点包括：
<ol start="1">
<li>
使用Fluent API精细配置一对一、一对多和多对多关系
</li>
<li>
正确处理迁移创建、应用和回滚
</li>
<li>
解决迁移过程中的常见问题
</li>
<li>
使用多种方法添加和管理种子数据
</li>
<li>
处理复杂场景如条件种子数据和外部数据源
</li>
</ol>
正确配置关系和迁移是构建健壮数据访问层的关键，而合理的种子数据策略可以大大简化开发和测试过程。
 
</div>
</div>
</div>
</div> 
来源：https://www.cnblogs.com/jixingsuiyuan/p/19094052

頁: [1]

琼殿技术论坛's Archiver

EF Core 与 MySQL：迁移和关系配置详解