與開發(fā)模式全解析：從入門到實(shí)戰(zhàn)優(yōu)化)
1. 項(xiàng)目概述為什么EF是.NET開發(fā)者的必修課如果你剛開始接觸.NET開發(fā)或者從ADO.NET、Dapper這類“手動(dòng)擋”O(jiān)RM轉(zhuǎn)過來第一次聽到Entity FrameworkEF這個(gè)名字可能會有點(diǎn)懵。這玩意兒到底是啥簡單說EF是微軟官方出品的一個(gè)對象關(guān)系映射ORM框架。它的核心任務(wù)就是幫你把數(shù)據(jù)庫里那些冷冰冰的表和行變成你代碼里活生生的類和對象。我剛開始用EF的時(shí)候也犯過嘀咕直接用SQL寫查詢不香嗎為什么要多學(xué)一層框架但踩過幾次坑之后我徹底明白了。當(dāng)你面對一個(gè)擁有幾十張表、復(fù)雜關(guān)聯(lián)的業(yè)務(wù)系統(tǒng)時(shí)手動(dòng)拼接SQL字符串、處理參數(shù)化查詢、將DataReader的結(jié)果一行行映射到對象屬性上……這些工作不僅繁瑣而且極易出錯(cuò)代碼維護(hù)起來簡直就是噩夢。EF的價(jià)值就在于它把這套臟活累活全包了。你只需要用C#寫寫LINQ查詢定義好實(shí)體類EF就能在背后幫你生成SQL、執(zhí)行命令、管理連接并把結(jié)果自動(dòng)填充到你的對象里。開發(fā)效率的提升不是一點(diǎn)半點(diǎn)。EF特別適合這幾類場景一是快速原型開發(fā)你腦子里有個(gè)業(yè)務(wù)模型用Code First方式幾分鐘就能把數(shù)據(jù)庫建起來二是中大型業(yè)務(wù)系統(tǒng)表結(jié)構(gòu)復(fù)雜、關(guān)聯(lián)多EF的導(dǎo)航屬性能讓關(guān)聯(lián)查詢變得異常清晰三是團(tuán)隊(duì)協(xié)作項(xiàng)目統(tǒng)一的ORM框架能極大降低溝通成本避免“SQL方言”滿天飛。當(dāng)然它也不是銀彈。對于極致性能要求、需要高度定制化SQL的復(fù)雜報(bào)表查詢或者存量存儲過程特別多的老系統(tǒng)你可能需要搭配Dapper這樣的微型ORM或者直接使用EF Core的原始SQL功能。但無論如何掌握EF是每一位現(xiàn)代.NET后端開發(fā)者構(gòu)建數(shù)據(jù)訪問層最基礎(chǔ)、最核心的技能之一說它是必修課毫不為過。2. EF核心架構(gòu)與三種開發(fā)模式解析要玩轉(zhuǎn)EF首先得搞清楚它的“工作模式”。EF主要提供了三種開發(fā)模式每種模式思路不同適用場景也不同。選對了模式事半功倍選錯(cuò)了可能步步維艱。2.1 Database First從現(xiàn)有數(shù)據(jù)庫出發(fā)如果你的項(xiàng)目已經(jīng)有一個(gè)設(shè)計(jì)好的數(shù)據(jù)庫或者你需要對接一個(gè)遺留系統(tǒng)那么Database First數(shù)據(jù)庫優(yōu)先可能是最直接的入門方式。它的工作流是數(shù)據(jù)庫已經(jīng)存在 - 使用Visual Studio的“ADO.NET實(shí)體數(shù)據(jù)模型”向?qū)Х聪蚬こ躺蓪?shí)體類.cs文件和上下文DbContext- 在代碼中操作這些生成的類。這么做的最大好處是“穩(wěn)”。你的代碼模型嚴(yán)格遵循數(shù)據(jù)庫結(jié)構(gòu)幾乎不會出現(xiàn)模型與數(shù)據(jù)庫不同步的問題。對于數(shù)據(jù)庫主導(dǎo)的項(xiàng)目或者DBA權(quán)力比較大的團(tuán)隊(duì)這種模式很受歡迎。但是它的缺點(diǎn)也很明顯生成的實(shí)體類代碼通常比較“胖”里面充滿了EF的特性標(biāo)簽如[Key],[ForeignKey]而且一旦數(shù)據(jù)庫表結(jié)構(gòu)發(fā)生變化你需要更新這個(gè)EDMX模型或使用Scaffold-DbContext命令重新生成這可能會覆蓋你手寫的一些自定義邏輯。所以Database First模式更像是一種“對接”和“遷移”策略適合快速起步但長期來看對代碼的控制力較弱。2.2 Model First在可視化設(shè)計(jì)中建模Model First模型優(yōu)先模式現(xiàn)在用得相對少了但在某些場景下仍有其價(jià)值。你不需要先有數(shù)據(jù)庫而是在Visual Studio的設(shè)計(jì)器里用拖拽的方式畫出一個(gè)實(shí)體關(guān)系圖ER圖。設(shè)計(jì)器幫你生成實(shí)體類的代碼同時(shí)也能根據(jù)這個(gè)模型生成創(chuàng)建數(shù)據(jù)庫的SQL腳本。這種模式非常直觀尤其適合那些對數(shù)據(jù)庫SQL不熟但熟悉UML或類圖的設(shè)計(jì)者。你可以專注于業(yè)務(wù)實(shí)體的定義和它們之間的關(guān)系而不用操心具體的表字段類型。然而它的靈活性是三種模式中最差的。一旦模型復(fù)雜起來設(shè)計(jì)器可能變得難以維護(hù)而且從模型同步到數(shù)據(jù)庫的過程有時(shí)會丟失一些數(shù)據(jù)庫特有的優(yōu)化設(shè)置。對于追求代碼即設(shè)計(jì)、版本控制友好的現(xiàn)代開發(fā)流程來說Model First顯得有點(diǎn)笨重。2.3 Code First以代碼定義一切的現(xiàn)代方式這是目前EF社區(qū)最主流、也是最推薦的方式尤其是EF Core幾乎完全圍繞此模式構(gòu)建。Code First代碼優(yōu)先的核心思想是你的領(lǐng)域模型實(shí)體類就是唯一的真相來源。你先用純C#代碼定義實(shí)體類及其關(guān)系然后通過EF的遷移Migration功能將這些模型變化同步到數(shù)據(jù)庫。舉個(gè)例子你想定義一個(gè)博客Blog和文章Post的模型public class Blog { public int BlogId { get; set; } public string Url { get; set; } // 導(dǎo)航屬性一個(gè)博客有多篇文章 public ListPost Posts { get; set; } } public class Post { public int PostId { get; set; } public string Title { get; set; } public string Content { get; set; } // 外鍵屬性可省略EF能推斷 public int BlogId { get; set; } // 導(dǎo)航屬性一篇文章屬于一個(gè)博客 public Blog Blog { get; set; } }然后你定義一個(gè)繼承自DbContext的類public class BloggingContext : DbContext { public DbSetBlog Blogs { get; set; } public DbSetPost Posts { get; set; } protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { // 配置連接字符串這里用SQLite示例 optionsBuilder.UseSqlite(Data Sourceblogging.db); } }接下來在程序包管理器控制臺執(zhí)行兩個(gè)命令A(yù)dd-Migration InitialCreate Update-DatabaseEF Core就會檢查你的模型生成名為“InitialCreate”的遷移文件里面是C#代碼描述了要進(jìn)行的數(shù)據(jù)庫操作然后執(zhí)行這個(gè)遷移在數(shù)據(jù)庫中創(chuàng)建Blogs和Posts兩張表并建立外鍵關(guān)系。Code First的優(yōu)勢是巨大的完全的控制權(quán)模型是干凈的POCO類、優(yōu)秀的版本控制遷移文件是C#代碼可以像其他代碼一樣簽入Git、持續(xù)集成/交付友好遷移可以自動(dòng)化執(zhí)行。它代表了“基礎(chǔ)設(shè)施即代碼”的思想在數(shù)據(jù)層的實(shí)踐。對于新項(xiàng)目我強(qiáng)烈建議直接從Code First開始。它需要你理解一些約定如Id或[類名]Id屬性會被默認(rèn)設(shè)為主鍵但一旦掌握你會愛上這種開發(fā)體驗(yàn)。注意選擇哪種模式不是技術(shù)優(yōu)劣問題更多的是項(xiàng)目上下文和團(tuán)隊(duì)習(xí)慣問題。但對于新手我建議的學(xué)習(xí)路徑是先用Code First寫個(gè)小demo理解實(shí)體、上下文、遷移的核心概念然后再去了解Database First知道如何與現(xiàn)有數(shù)據(jù)庫協(xié)作。這樣你能建立起最完整的概念體系。3. 核心組件深度拆解DbContext與DbSet理解了模式我們深入到EF的核心運(yùn)行時(shí)組件。如果把EF比作一個(gè)工廠那么DbContext就是廠長DbSetT就是各個(gè)生產(chǎn)車間。3.1 DbContext數(shù)據(jù)操作的指揮中心DbContext是你與數(shù)據(jù)庫交互的主要入口。它不僅僅是一個(gè)數(shù)據(jù)庫連接的包裝更是一個(gè)功能強(qiáng)大的工作單元Unit of Work和變更跟蹤器Change Tracker的結(jié)合體。工作單元模式這意味著你在一個(gè)DbContext實(shí)例的生命周期內(nèi)通常是一個(gè)Web請求進(jìn)行的多次增刪改查操作會被集中管理。只有當(dāng)你調(diào)用SaveChanges()或SaveChangesAsync()時(shí)所有這些變更才會被一次性、以事務(wù)的方式提交到數(shù)據(jù)庫。這保證了數(shù)據(jù)的一致性。比如你先后添加了一個(gè)用戶和一條該用戶的訂單記錄如果中間某步出錯(cuò)整個(gè)SaveChanges操作會回滾不會出現(xiàn)用戶創(chuàng)建了訂單卻沒記錄的情況。變更跟蹤這是EF的魔法之一。當(dāng)你從數(shù)據(jù)庫查詢出一個(gè)實(shí)體對象后DbContext會記住這個(gè)對象最初的狀態(tài)。之后你在代碼中修改了這個(gè)對象的屬性。當(dāng)你調(diào)用SaveChanges時(shí)EF的變更跟蹤器會對比當(dāng)前狀態(tài)和原始狀態(tài)自動(dòng)生成只更新那些被修改過的字段的SQL語句。你不需要手動(dòng)寫UPDATE ... SET Name新值 WHERE Id1EF幫你高效地完成了。配置與連接管理DbContext也負(fù)責(zé)配置數(shù)據(jù)庫提供程序SQL Server、SQLite、PostgreSQL等、連接字符串以及定義模型的高級配置通過OnModelCreating方法。一個(gè)典型的上下文配置如下public class AppDbContext : DbContext { public AppDbContext(DbContextOptionsAppDbContext options) : base(options) // 依賴注入推薦方式 { } public DbSetUser Users { get; set; } public DbSetOrder Orders { get; set; } protected override void OnModelCreating(ModelBuilder modelBuilder) { // 在這里進(jìn)行Fluent API配置例如定義復(fù)合主鍵、索引等 modelBuilder.EntityUser() .HasIndex(u u.Email) .IsUnique(); // 為Email字段創(chuàng)建唯一索引 } }在ASP.NET Core中我們通常會在Startup.cs或Program.cs中通過依賴注入來配置和獲取DbContext這能更好地管理其生命周期默認(rèn)為Scoped即一次請求一個(gè)實(shí)例。3.2 DbSet 實(shí)體集合的抽象DbSetT代表了數(shù)據(jù)庫中特定表的抽象。你可以把它看作是一個(gè)內(nèi)存中的集合但它的背后是數(shù)據(jù)庫。通過DbSetT你可以執(zhí)行所有的CRUD操作。查詢QueryDbSetT實(shí)現(xiàn)了IQueryableT這是LINQ to Entities的基石。當(dāng)你寫context.Users.Where(u u.Age 18)時(shí)你得到的是一個(gè)IQueryableUser對象。這個(gè)查詢還沒有執(zhí)行它只是一個(gè)表達(dá)式樹。EF會在你需要結(jié)果的時(shí)候例如調(diào)用.ToList()、.FirstOrDefault()或foreach遍歷時(shí)才將這顆表達(dá)式樹翻譯成SQL發(fā)送到數(shù)據(jù)庫執(zhí)行。這種“延遲執(zhí)行”機(jī)制非常高效允許你動(dòng)態(tài)構(gòu)建復(fù)雜的查詢。添加Addcontext.Users.Add(newUser)將一個(gè)新實(shí)體標(biāo)記為“Added”狀態(tài)。此時(shí)它只在內(nèi)存的變更跟蹤器中數(shù)據(jù)庫里還沒有。直到SaveChanges被調(diào)用INSERT語句才會生成并執(zhí)行。更新Update對于已跟蹤的實(shí)體比如剛從數(shù)據(jù)庫查出來的直接修改其屬性即可。對于未跟蹤的實(shí)體比如從HTTP請求反序列化出來的你需要調(diào)用context.Users.Update(existingUser)來將其附加到上下文并標(biāo)記為“Modified”狀態(tài)。刪除Removecontext.Users.Remove(user)將實(shí)體標(biāo)記為“Deleted”狀態(tài)。關(guān)于DbSet的一個(gè)關(guān)鍵理解DbSet并不包含所有數(shù)據(jù)。context.Users本身不代表“Users表中的所有行”它代表的是一個(gè)“針對Users表的查詢?nèi)肟凇?。?dāng)你執(zhí)行context.Users.ToList()才是真的把所有數(shù)據(jù)取到內(nèi)存。在Web應(yīng)用中一定要避免不經(jīng)篩選就直接ToList()大表這會導(dǎo)致全表掃描性能災(zāi)難。正確的做法是始終先通過Where、Take、Skip等操作在數(shù)據(jù)庫端完成過濾和分頁。4. 數(shù)據(jù)建模與關(guān)系配置實(shí)戰(zhàn)定義好實(shí)體類只是第一步如何精確地描述它們之間的關(guān)系和約束才是建模的核心。EF主要通過兩種方式來配置模型數(shù)據(jù)注解Data Annotations和Fluent API。4.1 數(shù)據(jù)注解聲明式的簡單配置數(shù)據(jù)注解是以特性Attribute的方式直接標(biāo)注在實(shí)體類的屬性上。這種方式非常直觀適合簡單的配置。using System.ComponentModel.DataAnnotations; using System.ComponentModel.DataAnnotations.Schema; public class Book { [Key] // 顯式指定主鍵 public int BookId { get; set; } [Required] // 非空約束 [MaxLength(100)] // 最大長度 public string Title { get; set; } [Column(TypeName decimal(18, 2))] // 指定數(shù)據(jù)庫列類型 public decimal Price { get; set; } [ForeignKey(AuthorId)] // 指定外鍵屬性名 public int AuthorId { get; set; } [ForeignKey(AuthorId)] public Author Author { get; set; } // 導(dǎo)航屬性 }數(shù)據(jù)注解的優(yōu)點(diǎn)是清晰、集中一眼就能看到這個(gè)屬性的所有約束。但它也有局限一是配置分散在各個(gè)實(shí)體類中對于復(fù)雜的模型關(guān)系查看起來不夠整體二是有些高級配置如復(fù)合鍵、繼承映射、并發(fā)令牌等用數(shù)據(jù)注解無法實(shí)現(xiàn)或非常別扭。4.2 Fluent API強(qiáng)大而靈活的流式配置Fluent API在DbContext的OnModelCreating方法中配置。它功能更強(qiáng)大是進(jìn)行復(fù)雜、精細(xì)模型配置的首選方式。protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.EntityBook(entity { // 配置主鍵 entity.HasKey(e e.BookId); // 配置屬性 entity.Property(e e.Title) .IsRequired() .HasMaxLength(100); entity.Property(e e.Price) .HasColumnType(decimal(18, 2)); // 配置一對一關(guān)系 entity.HasOne(e e.Author) .WithMany(a a.Books) // 假設(shè)Author有ICollectionBook Books屬性 .HasForeignKey(e e.AuthorId) .OnDelete(DeleteBehavior.Cascade); // 級聯(lián)刪除作者刪了書也全刪 // 配置索引 entity.HasIndex(e e.Title); entity.HasIndex(e new { e.AuthorId, e.PublishedDate }); // 復(fù)合索引 }); // 配置多對多關(guān)系EF Core 5.0 modelBuilder.EntityBook() .HasMany(b b.Tags) .WithMany(t t.Books) .UsingEntity(j j.ToTable(BookTags)); // 指定連接表名 }Fluent API就像在編寫數(shù)據(jù)庫的Schema定義但用的是C#語法。它能實(shí)現(xiàn)所有數(shù)據(jù)注解的功能并且更多比如精確控制級聯(lián)刪除行為Restrict拒絕刪除、Cascade級聯(lián)刪除、SetNull設(shè)為空等。配置繼承映射策略TPH每層次結(jié)構(gòu)一張表、TPT每類型一張表、TPC每具體類一張表。配置并發(fā)控制使用IsConcurrencyToken()配置行版本或時(shí)間戳字段防止更新沖突。配置值對象Owned Entity Types將某個(gè)復(fù)雜類型映射到主實(shí)體的同一張表中。我的經(jīng)驗(yàn)是對于簡單的字段約束如[Required],[MaxLength]用數(shù)據(jù)注解很方便。但對于關(guān)系配置和任何復(fù)雜的、影響數(shù)據(jù)庫Schema的配置一律使用Fluent API。這樣所有配置都集中在OnModelCreating這一個(gè)地方維護(hù)和查閱起來一目了然更像一份正式的“數(shù)據(jù)契約”。4.3 關(guān)系映射的陷阱與最佳實(shí)踐定義關(guān)系時(shí)有幾個(gè)坑新手很容易掉進(jìn)去循環(huán)引用與序列化如果Author有Books集合Book又有Author導(dǎo)航屬性在通過Web API返回JSON時(shí)序列化器如Newtonsoft.Json或System.Text.Json可能會陷入無限循環(huán)。解決方案是在導(dǎo)航屬性上添加[JsonIgnore]特性或者配置序列化選項(xiàng)忽略循環(huán)引用更優(yōu)雅的方式是使用DTO數(shù)據(jù)傳輸對象來返回?cái)?shù)據(jù)而不是直接返回實(shí)體。延遲加載與N1查詢問題假設(shè)你遍歷所有作者然后打印每個(gè)作者的所有書名var authors context.Authors.ToList(); foreach (var author in authors) { Console.WriteLine(${author.Name}寫了); foreach (var book in author.Books) // 這里會觸發(fā)延遲加載為每個(gè)作者單獨(dú)發(fā)一次查詢 { Console.WriteLine($ - {book.Title}); } }這會導(dǎo)致“N1查詢問題”1次查詢獲取所有作者然后為每個(gè)作者再發(fā)起1次查詢獲取他的書。如果作者有100個(gè)就是101次查詢性能極差。解決方案是使用顯式加載Include或投影查詢Select在第一次查詢時(shí)就加載好關(guān)聯(lián)數(shù)據(jù)// 方法1使用Include顯式加載貪婪加載 var authorsWithBooks context.Authors .Include(a a.Books) .ToList(); // 方法2使用Select投影只取所需數(shù)據(jù)通常更高效 var authorInfo context.Authors .Select(a new { a.Name, BookTitles a.Books.Select(b b.Title).ToList() }) .ToList();外鍵屬性是可選的但推薦顯式定義EF Core可以通過約定推斷出外鍵例如AuthorId但顯式定義一個(gè)AuthorId屬性會讓你的代碼意圖更清晰并且在某些需要直接操作外鍵值的場景下比如批量更新更方便。5. LINQ查詢與數(shù)據(jù)操作全指南EF的強(qiáng)大一半體現(xiàn)在它無縫集成了LINQ。你可以用寫C#集合操作的方式來編寫數(shù)據(jù)庫查詢。5.1 LINQ to Entities查詢基礎(chǔ)LINQ查詢有兩種語法查詢表達(dá)式語法類似SQL和方法語法鏈?zhǔn)秸{(diào)用。方法語法更常用也更靈活。// 方法語法示例 var popularBooks context.Books .Where(b b.Price 50 b.PublishDate.Year 2020) .OrderByDescending(b b.Rating) .ThenBy(b b.Title) .Take(10) .ToList(); // 注意ToList()是觸發(fā)查詢執(zhí)行的地方 // 等效的查詢表達(dá)式語法 var popularBooks2 (from b in context.Books where b.Price 50 b.PublishDate.Year 2020 orderby b.Rating descending, b.Title select b).Take(10).ToList();關(guān)鍵點(diǎn)在于在調(diào)用ToList()、FirstOrDefault()、Count()、Any()等方法之前查詢只是一個(gè)表達(dá)式樹沒有執(zhí)行。這允許你動(dòng)態(tài)構(gòu)建查詢IQueryableBook query context.Books; if (!string.IsNullOrEmpty(searchTitle)) { query query.Where(b b.Title.Contains(searchTitle)); } if (minPrice.HasValue) { query query.Where(b b.Price minPrice.Value); } var finalResult query.OrderBy(b b.Price).ToList();5.2 加載關(guān)聯(lián)數(shù)據(jù)Include與ThenInclude如前所述使用Include來避免N1查詢。// 加載單層關(guān)聯(lián) var blogs context.Blogs .Include(b b.Posts) // 加載Blog的Posts集合 .ToList(); // 加載多層關(guān)聯(lián)嵌套的ThenInclude var blogsWithDetails context.Blogs .Include(b b.Posts) .ThenInclude(p p.Author) // 加載每篇Post的Author .Include(b b.Owner) // 加載Blog的Owner另一個(gè)導(dǎo)航屬性 .ToList();Include是貪婪加載它會將關(guān)聯(lián)的數(shù)據(jù)一次性通過JOIN查詢出來。對于深層或大型關(guān)聯(lián)要小心可能產(chǎn)生的巨大結(jié)果集和“笛卡爾積爆炸”問題。有時(shí)分多次查詢使用Load方法或使用投影Select可能是更好的選擇。5.3 增刪改查與SaveChanges新增var newBlog new Blog { Url http://newblog.com }; context.Blogs.Add(newBlog); // 標(biāo)記為Added // 或者 context.Add(newBlog); DbContext有非泛型Add方法 await context.SaveChangesAsync(); // 執(zhí)行INSERTnewBlog的Id會被數(shù)據(jù)庫自動(dòng)填充更新var blog await context.Blogs.FindAsync(1); // 先查詢出實(shí)體此時(shí)它被上下文跟蹤 if (blog ! null) { blog.Url http://updated.com; // 直接修改屬性 await context.SaveChangesAsync(); // 生成UPDATE語句只更新Url字段 }對于從MVC/API控制器接收的模型未被上下文跟蹤你需要告訴EF這是更新// blogFromClient是從HTTP請求反序列化得到的對象有Id context.Blogs.Update(blogFromClient); // 標(biāo)記整個(gè)實(shí)體為Modified // 或者更精細(xì)地操作 var existingBlog await context.Blogs.FindAsync(blogFromClient.BlogId); context.Entry(existingBlog).CurrentValues.SetValues(blogFromClient); // 只復(fù)制變化的屬性 await context.SaveChangesAsync();刪除var blog await context.Blogs.FindAsync(1); if (blog ! null) { context.Blogs.Remove(blog); await context.SaveChangesAsync(); } // 或者使用簡化刪除無需先查詢但需確保實(shí)體狀態(tài)正確 var blogToDelete new Blog { BlogId 1 }; context.Blogs.Attach(blogToDelete); context.Blogs.Remove(blogToDelete); await context.SaveChangesAsync();SaveChanges的工作原理當(dāng)你調(diào)用它時(shí)EF的變更跟蹤器會檢查所有被跟蹤的實(shí)體找出狀態(tài)為Added、Modified、Deleted的實(shí)體。然后它為這些變更生成相應(yīng)的INSERT、UPDATE、DELETE語句并在一個(gè)事務(wù)中執(zhí)行它們。如果所有語句都成功事務(wù)提交如果任何一條失敗事務(wù)回滾數(shù)據(jù)庫保持原樣并拋出異常。這保證了操作的原子性。5.4 原生SQL與存儲過程雖然LINQ很強(qiáng)但有些復(fù)雜查詢或性能關(guān)鍵路徑你可能需要寫原生SQL。EF Core提供了很好的支持。// 執(zhí)行返回實(shí)體的查詢 var blogs context.Blogs .FromSqlRaw(SELECT * FROM Blogs WHERE Rating {0}, 5) .ToList(); // 執(zhí)行非查詢命令增刪改 var rowsAffected context.Database.ExecuteSqlRaw( UPDATE Blogs SET Rating Rating 1 WHERE BlogId {0}, blogId); // 調(diào)用存儲過程查詢 var blogsFromSp context.Blogs .FromSqlRaw(EXECUTE dbo.GetPopularBlogs minRating{0}, 5) .ToList();使用原生SQL時(shí)務(wù)必使用參數(shù)化查詢像上面例子中用{0}占位符絕對不要用字符串拼接以防止SQL注入攻擊。EF Core會將占位符轉(zhuǎn)換為安全的參數(shù)化查詢。6. 遷移Migration管理數(shù)據(jù)庫的版本控制Code First模式的核心支柱就是遷移。遷移是一組按順序應(yīng)用的、使數(shù)據(jù)庫架構(gòu)與模型保持同步的指令。它就像是數(shù)據(jù)庫的Git。6.1 遷移工作流創(chuàng)建遷移當(dāng)你的實(shí)體類發(fā)生變化新增、修改、刪除在程序包管理器控制臺執(zhí)行Add-Migration [遷移名稱]例如Add-Migration AddBlogRating。EF Core會比較當(dāng)前模型與上一次遷移時(shí)的模型快照生成一個(gè)遷移文件如20250101010101_AddBlogRating.cs里面包含Up和Down方法。Up方法描述如何將數(shù)據(jù)庫升級到新版本Down方法描述如何回退到舊版本。檢查遷移生成的遷移文件是C#代碼你應(yīng)該審查它特別是它生成的SQL操作是否符合預(yù)期。你可以使用Script-Migration命令生成SQL腳本而不執(zhí)行。應(yīng)用遷移Update-Database這個(gè)命令會將所有未應(yīng)用的遷移應(yīng)用到數(shù)據(jù)庫。在開發(fā)環(huán)境這通常直接執(zhí)行。在生產(chǎn)環(huán)境你應(yīng)該使用生成的SQL腳本在可控的數(shù)據(jù)庫部署流程中執(zhí)行?；貪L遷移如果最新遷移有問題可以回滾到上一個(gè)版本Update-Database [上一個(gè)遷移的名稱]或者直接刪除最新的遷移文件確保數(shù)據(jù)庫已回滾或未應(yīng)用然后重新創(chuàng)建。6.2 遷移的常見問題與技巧遷移文件沖突在團(tuán)隊(duì)開發(fā)中如果兩個(gè)人同時(shí)添加了遷移可能會產(chǎn)生沖突。解決方法是先回滾本地未提交的遷移Update-Database到共同祖先拉取隊(duì)友的遷移并應(yīng)用然后重新添加自己的遷移。最好通過團(tuán)隊(duì)規(guī)范來避免同時(shí)添加遷移。自定義遷移SQL有時(shí)自動(dòng)生成的遷移不夠優(yōu)化或者你需要執(zhí)行一些特殊操作如初始化數(shù)據(jù)、創(chuàng)建復(fù)雜索引。你可以在Up方法中直接編寫SQLprotected override void Up(MigrationBuilder migrationBuilder) { migrationBuilder.AddColumnint( name: Rating, table: Blogs, nullable: false, defaultValue: 0); // 自定義SQL為所有老博客設(shè)置一個(gè)初始評分 migrationBuilder.Sql(UPDATE Blogs SET Rating 5 WHERE CreatedDate 2024-01-01); }生產(chǎn)環(huán)境部署千萬不要在生產(chǎn)服務(wù)器上直接運(yùn)行Update-Database。應(yīng)該使用Script-Migration -Idempotent命令生成一個(gè)冪等的SQL腳本。這個(gè)腳本包含了檢查遷移是否已應(yīng)用的邏輯可以安全地在CI/CD管道中或由DBA執(zhí)行。敏感數(shù)據(jù)如連接字符串不要在遷移代碼或DbContext配置中硬編碼連接字符串。應(yīng)該使用配置系統(tǒng)如appsettings.json和用戶機(jī)密開發(fā)時(shí)或環(huán)境變量生產(chǎn)時(shí)來管理。7. 性能優(yōu)化與常見陷阱規(guī)避EF用起來爽但用不好也容易成為性能瓶頸。下面是一些關(guān)鍵的優(yōu)化點(diǎn)和避坑指南。7.1 查詢性能優(yōu)化只選擇需要的字段投影這是最重要的優(yōu)化原則。不要總是Select *。// 不好查詢整個(gè)實(shí)體 var blogs context.Blogs.ToList(); // 好只查詢需要的字段 var blogTitles context.Blogs.Select(b new { b.BlogId, b.Url }).ToList();投影查詢返回的是匿名類型或DTO它們不會被變更跟蹤內(nèi)存占用小傳輸?shù)臄?shù)據(jù)量也少。警惕延遲加載在Web應(yīng)用或服務(wù)中強(qiáng)烈建議顯式關(guān)閉延遲加載。延遲加載會導(dǎo)致不可預(yù)知的數(shù)據(jù)庫查詢N1問題并且通常是在序列化響應(yīng)時(shí)觸發(fā)難以監(jiān)控和調(diào)試。在DbContext配置中設(shè)置LazyLoadingEnabled false并強(qiáng)制自己使用Include或投影。分頁分頁再分頁對于任何可能返回大量數(shù)據(jù)的查詢必須分頁。var pageNumber 1; var pageSize 20; var pagedBlogs context.Blogs .OrderBy(b b.BlogId) .Skip((pageNumber - 1) * pageSize) .Take(pageSize) .ToList();使用Skip和Take在數(shù)據(jù)庫端完成分頁而不是把所有數(shù)據(jù)取到內(nèi)存再分片。使用異步方法為了不阻塞線程提高應(yīng)用吞吐量盡量使用ToListAsync()、FirstOrDefaultAsync()、SaveChangesAsync()等異步方法。7.2 變更跟蹤與上下文生命周期DbContext不是單例DbContext設(shè)計(jì)為輕量級、短生命周期的對象。在ASP.NET Core中默認(rèn)注冊為Scoped生命周期每個(gè)請求一個(gè)實(shí)例。絕對不要將其注冊為Singleton否則變更跟蹤器會積累大量實(shí)體導(dǎo)致內(nèi)存泄漏和并發(fā)問題。適時(shí)使用AsNoTracking對于只讀查詢?nèi)绻愦_定后續(xù)不會修改這些實(shí)體并調(diào)用SaveChanges使用AsNoTracking可以顯著提升查詢性能因?yàn)镋F不會為這些實(shí)體建立變更跟蹤快照。var readOnlyBlogs context.Blogs.AsNoTracking().Where(b b.Rating 4).ToList();批量操作優(yōu)化EF Core 7.0 對批量更新和刪除提供了更好的支持ExecuteUpdate和ExecuteDelete它們會生成一條SQL語句而不是先查詢再逐條操作。// 傳統(tǒng)方式低效先查詢再循環(huán)修改最后SaveChanges // var blogs context.Blogs.Where(b b.Rating 3).ToList(); // foreach(var b in blogs) b.Rating 3; // context.SaveChanges(); // 高效批量更新EF Core 7.0 await context.Blogs .Where(b b.Rating 3) .ExecuteUpdateAsync(setters setters.SetProperty(b b.Rating, 3)); // 高效批量刪除 await context.Blogs .Where(b b.CreatedDate.Year 2020) .ExecuteDeleteAsync();對于大量數(shù)據(jù)的插入考慮使用DbContext的AddRange并合理設(shè)置SaveChanges的批次大小DbContextOptionsBuilder可以配置MaxBatchSize或者使用像SqlBulkCopy這樣的專門工具。7.3 日志與監(jiān)控打開EF Core的日志記錄是了解其背后做了什么、發(fā)現(xiàn)性能問題的關(guān)鍵。// 在DbContext配置中啟用簡單日志開發(fā)環(huán)境 optionsBuilder.UseSqlServer(connectionString) .LogTo(Console.WriteLine, LogLevel.Information); // 將日志輸出到控制臺 // 或者在ASP.NET Core中使用ILogger optionsBuilder.UseSqlServer(connectionString) .LogTo((message) logger.LogInformation(message), LogLevel.Information);查看日志你可以看到EF生成的SQL語句、執(zhí)行時(shí)間、參數(shù)等。特別注意那些“重復(fù)查詢”和“查詢了過多不必要字段”的日志。8. 實(shí)戰(zhàn)構(gòu)建一個(gè)簡單的博客系統(tǒng)數(shù)據(jù)層讓我們把上面的知識串起來快速構(gòu)建一個(gè)博客系統(tǒng)的核心數(shù)據(jù)層。假設(shè)我們有Blog,Post,Comment,Tag實(shí)體。第一步定義實(shí)體public class Blog { public int BlogId { get; set; } [Required, MaxLength(200)] public string Url { get; set; } public int Rating { get; set; } 0; public DateTime CreatedDate { get; set; } DateTime.UtcNow; // 導(dǎo)航屬性 public ListPost Posts { get; set; } new ListPost(); } public class Post { public int PostId { get; set; } [Required, MaxLength(500)] public string Title { get; set; } public string Content { get; set; } public DateTime PublishedDate { get; set; } public bool IsPublished { get; set; } public int BlogId { get; set; } public Blog Blog { get; set; } public ListComment Comments { get; set; } new ListComment(); public ListTag Tags { get; set; } new ListTag(); } public class Comment { public int CommentId { get; set; } public string Author { get; set; } public string Content { get; set; } public DateTime CreatedAt { get; set; } DateTime.UtcNow; public int PostId { get; set; } public Post Post { get; set; } } public class Tag { public int TagId { get; set; } [Required, MaxLength(50)] public string Name { get; set; } public ListPost Posts { get; set; } new ListPost(); }第二步配置DbContext和關(guān)系public class BloggingContext : DbContext { public BloggingContext(DbContextOptionsBloggingContext options) : base(options) { } public DbSetBlog Blogs { get; set; } public DbSetPost Posts { get; set; } public DbSetComment Comments { get; set; } public DbSetTag Tags { get; set; } protected override void OnModelCreating(ModelBuilder modelBuilder) { // Blog 配置 modelBuilder.EntityBlog(entity { entity.HasKey(e e.BlogId); entity.HasIndex(e e.Url).IsUnique(); entity.Property(e e.Url).IsRequired().HasMaxLength(200); }); // Post 配置 modelBuilder.EntityPost(entity { entity.HasKey(e e.PostId); entity.Property(e e.Title).IsRequired().HasMaxLength(500); entity.Property(e e.PublishedDate).HasDefaultValueSql(GETUTCDATE()); // SQL Server語法 // Post - Blog (多對一) entity.HasOne(p p.Blog) .WithMany(b b.Posts) .HasForeignKey(p p.BlogId) .OnDelete(DeleteBehavior.Cascade); // 博客刪除文章也刪除 // Post - Tags (多對多) entity.HasMany(p p.Tags) .WithMany(t t.Posts) .UsingEntity(j j.ToTable(PostTags)); }); // Comment 配置 modelBuilder.EntityComment(entity { entity.HasKey(e e.CommentId); // Comment - Post (多對一) entity.HasOne(c c.Post) .WithMany(p p.Comments) .HasForeignKey(c c.PostId) .OnDelete(DeleteBehavior.Cascade); // 文章刪除評論也刪除 }); // Tag 配置 modelBuilder.EntityTag(entity { entity.HasKey(e e.TagId); entity.HasIndex(e e.Name).IsUnique(); // 標(biāo)簽名唯一 entity.Property(e e.Name).IsRequired().HasMaxLength(50); }); } }第三步在Program.cs中注冊服務(wù)var builder WebApplication.CreateBuilder(args); // 從配置中讀取連接字符串 var connectionString builder.Configuration.GetConnectionString(DefaultConnection); // 注冊DbContext使用SQL Server builder.Services.AddDbContextBloggingContext(options options.UseSqlServer(connectionString) .LogTo(Console.WriteLine, LogLevel.Information) // 開發(fā)時(shí)看SQL日志 ); var app builder.Build(); // ... 中間件配置 app.Run();第四步創(chuàng)建并應(yīng)用初始遷移在程序包管理器控制臺確保默認(rèn)項(xiàng)目是你的數(shù)據(jù)層項(xiàng)目Add-Migration InitialCreate Update-Database第五步在服務(wù)中使用public class BlogService { private readonly BloggingContext _context; public BlogService(BloggingContext context) { _context context; } public async TaskListBlogSummaryDto GetPopularBlogsAsync(int topN) { // 使用投影查詢只取所需數(shù)據(jù)避免N1 var blogs await _context.Blogs .Where(b b.Rating 3) .OrderByDescending(b b.Rating) .Take(topN) .Select(b new BlogSummaryDto { BlogId b.BlogId, Url b.Url, PostCount b.Posts.Count(p p.IsPublished) // 在數(shù)據(jù)庫端計(jì)數(shù) }) .AsNoTracking() // 只讀不跟蹤 .ToListAsync(); return blogs; } public async Task AddPostToBlogAsync(int blogId, CreatePostDto newPost) { // 假設(shè)newPost包含Title, Content, TagIds var post new Post { Title newPost.Title, Content newPost.Content, BlogId blogId, IsPublished true, PublishedDate DateTime.UtcNow }; // 處理多對多關(guān)系關(guān)聯(lián)標(biāo)簽 if (newPost.TagIds?.Any() true) { var tags await _context.Tags .Where(t newPost.TagIds.Contains(t.TagId)) .ToListAsync(); post.Tags.AddRange(tags); } _context.Posts.Add(post); await _context.SaveChangesAsync(); } }這個(gè)簡單的例子涵蓋了實(shí)體定義、復(fù)雜關(guān)系配置一對多、多對多、Fluent API使用、依賴注入、查詢優(yōu)化投影、AsNoTracking以及服務(wù)層操作。從這里出發(fā)你可以根據(jù)業(yè)務(wù)需求不斷增加新的實(shí)體和復(fù)雜的查詢邏輯。記住EF是一個(gè)強(qiáng)大的工具但理解其原理和最佳實(shí)踐才能讓它真正為你的項(xiàng)目賦能而不是成為負(fù)擔(dān)。 Entity Framework核心架構(gòu)與開發(fā)模式全解析：從入門到實(shí)戰(zhàn)優(yōu)化
1. 項(xiàng)目概述為什么EF是.NET開發(fā)者的必修課如果你剛開始接觸.NET開發(fā)或者從ADO.NET、Dapper這類“手動(dòng)擋”O(jiān)RM轉(zhuǎn)過來第一次聽到Entity FrameworkEF這個(gè)名字可能會有點(diǎn)懵。這玩意兒到底是啥簡單說EF是微軟官方出品的一個(gè)對象關(guān)系映射ORM框架。它的核心任務(wù)就是幫你把數(shù)據(jù)庫里那些冷冰冰的表和行變成你代碼里活生生的類和對象。我剛開始用EF的時(shí)候也犯過嘀咕直接用SQL寫查詢不香嗎為什么要多學(xué)一層框架但踩過幾次坑之后我徹底明白了。當(dāng)你面對一個(gè)擁有幾十張表、復(fù)雜關(guān)聯(lián)的業(yè)務(wù)系統(tǒng)時(shí)手動(dòng)拼接SQL字符串、處理參數(shù)化查詢、將DataReader的結(jié)果一行行映射到對象屬性上……這些工作不僅繁瑣而且極易出錯(cuò)代碼維護(hù)起來簡直就是噩夢。EF的價(jià)值就在于它把這套臟活累活全包了。你只需要用C#寫寫LINQ查詢定義好實(shí)體類EF就能在背后幫你生成SQL、執(zhí)行命令、管理連接并把結(jié)果自動(dòng)填充到你的對象里。開發(fā)效率的提升不是一點(diǎn)半點(diǎn)。EF特別適合這幾類場景一是快速原型開發(fā)你腦子里有個(gè)業(yè)務(wù)模型用Code First方式幾分鐘就能把數(shù)據(jù)庫建起來二是中大型業(yè)務(wù)系統(tǒng)表結(jié)構(gòu)復(fù)雜、關(guān)聯(lián)多EF的導(dǎo)航屬性能讓關(guān)聯(lián)查詢變得異常清晰三是團(tuán)隊(duì)協(xié)作項(xiàng)目統(tǒng)一的ORM框架能極大降低溝通成本避免“SQL方言”滿天飛。當(dāng)然它也不是銀彈。對于極致性能要求、需要高度定制化SQL的復(fù)雜報(bào)表查詢或者存量存儲過程特別多的老系統(tǒng)你可能需要搭配Dapper這樣的微型ORM或者直接使用EF Core的原始SQL功能。但無論如何掌握EF是每一位現(xiàn)代.NET后端開發(fā)者構(gòu)建數(shù)據(jù)訪問層最基礎(chǔ)、最核心的技能之一說它是必修課毫不為過。2. EF核心架構(gòu)與三種開發(fā)模式解析要玩轉(zhuǎn)EF首先得搞清楚它的“工作模式”。EF主要提供了三種開發(fā)模式每種模式思路不同適用場景也不同。選對了模式事半功倍選錯(cuò)了可能步步維艱。2.1 Database First從現(xiàn)有數(shù)據(jù)庫出發(fā)如果你的項(xiàng)目已經(jīng)有一個(gè)設(shè)計(jì)好的數(shù)據(jù)庫或者你需要對接一個(gè)遺留系統(tǒng)那么Database First數(shù)據(jù)庫優(yōu)先可能是最直接的入門方式。它的工作流是數(shù)據(jù)庫已經(jīng)存在 - 使用Visual Studio的“ADO.NET實(shí)體數(shù)據(jù)模型”向?qū)Х聪蚬こ躺蓪?shí)體類.cs文件和上下文DbContext- 在代碼中操作這些生成的類。這么做的最大好處是“穩(wěn)”。你的代碼模型嚴(yán)格遵循數(shù)據(jù)庫結(jié)構(gòu)幾乎不會出現(xiàn)模型與數(shù)據(jù)庫不同步的問題。對于數(shù)據(jù)庫主導(dǎo)的項(xiàng)目或者DBA權(quán)力比較大的團(tuán)隊(duì)這種模式很受歡迎。但是它的缺點(diǎn)也很明顯生成的實(shí)體類代碼通常比較“胖”里面充滿了EF的特性標(biāo)簽如[Key],[ForeignKey]而且一旦數(shù)據(jù)庫表結(jié)構(gòu)發(fā)生變化你需要更新這個(gè)EDMX模型或使用Scaffold-DbContext命令重新生成這可能會覆蓋你手寫的一些自定義邏輯。所以Database First模式更像是一種“對接”和“遷移”策略適合快速起步但長期來看對代碼的控制力較弱。2.2 Model First在可視化設(shè)計(jì)中建模Model First模型優(yōu)先模式現(xiàn)在用得相對少了但在某些場景下仍有其價(jià)值。你不需要先有數(shù)據(jù)庫而是在Visual Studio的設(shè)計(jì)器里用拖拽的方式畫出一個(gè)實(shí)體關(guān)系圖ER圖。設(shè)計(jì)器幫你生成實(shí)體類的代碼同時(shí)也能根據(jù)這個(gè)模型生成創(chuàng)建數(shù)據(jù)庫的SQL腳本。這種模式非常直觀尤其適合那些對數(shù)據(jù)庫SQL不熟但熟悉UML或類圖的設(shè)計(jì)者。你可以專注于業(yè)務(wù)實(shí)體的定義和它們之間的關(guān)系而不用操心具體的表字段類型。然而它的靈活性是三種模式中最差的。一旦模型復(fù)雜起來設(shè)計(jì)器可能變得難以維護(hù)而且從模型同步到數(shù)據(jù)庫的過程有時(shí)會丟失一些數(shù)據(jù)庫特有的優(yōu)化設(shè)置。對于追求代碼即設(shè)計(jì)、版本控制友好的現(xiàn)代開發(fā)流程來說Model First顯得有點(diǎn)笨重。2.3 Code First以代碼定義一切的現(xiàn)代方式這是目前EF社區(qū)最主流、也是最推薦的方式尤其是EF Core幾乎完全圍繞此模式構(gòu)建。Code First代碼優(yōu)先的核心思想是你的領(lǐng)域模型實(shí)體類就是唯一的真相來源。你先用純C#代碼定義實(shí)體類及其關(guān)系然后通過EF的遷移Migration功能將這些模型變化同步到數(shù)據(jù)庫。舉個(gè)例子你想定義一個(gè)博客Blog和文章Post的模型public class Blog { public int BlogId { get; set; } public string Url { get; set; } // 導(dǎo)航屬性一個(gè)博客有多篇文章 public ListPost Posts { get; set; } } public class Post { public int PostId { get; set; } public string Title { get; set; } public string Content { get; set; } // 外鍵屬性可省略EF能推斷 public int BlogId { get; set; } // 導(dǎo)航屬性一篇文章屬于一個(gè)博客 public Blog Blog { get; set; } }然后你定義一個(gè)繼承自DbContext的類public class BloggingContext : DbContext { public DbSetBlog Blogs { get; set; } public DbSetPost Posts { get; set; } protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { // 配置連接字符串這里用SQLite示例 optionsBuilder.UseSqlite(Data Sourceblogging.db); } }接下來在程序包管理器控制臺執(zhí)行兩個(gè)命令A(yù)dd-Migration InitialCreate Update-DatabaseEF Core就會檢查你的模型生成名為“InitialCreate”的遷移文件里面是C#代碼描述了要進(jìn)行的數(shù)據(jù)庫操作然后執(zhí)行這個(gè)遷移在數(shù)據(jù)庫中創(chuàng)建Blogs和Posts兩張表并建立外鍵關(guān)系。Code First的優(yōu)勢是巨大的完全的控制權(quán)模型是干凈的POCO類、優(yōu)秀的版本控制遷移文件是C#代碼可以像其他代碼一樣簽入Git、持續(xù)集成/交付友好遷移可以自動(dòng)化執(zhí)行。它代表了“基礎(chǔ)設(shè)施即代碼”的思想在數(shù)據(jù)層的實(shí)踐。對于新項(xiàng)目我強(qiáng)烈建議直接從Code First開始。它需要你理解一些約定如Id或[類名]Id屬性會被默認(rèn)設(shè)為主鍵但一旦掌握你會愛上這種開發(fā)體驗(yàn)。注意選擇哪種模式不是技術(shù)優(yōu)劣問題更多的是項(xiàng)目上下文和團(tuán)隊(duì)習(xí)慣問題。但對于新手我建議的學(xué)習(xí)路徑是先用Code First寫個(gè)小demo理解實(shí)體、上下文、遷移的核心概念然后再去了解Database First知道如何與現(xiàn)有數(shù)據(jù)庫協(xié)作。這樣你能建立起最完整的概念體系。3. 核心組件深度拆解DbContext與DbSet理解了模式我們深入到EF的核心運(yùn)行時(shí)組件。如果把EF比作一個(gè)工廠那么DbContext就是廠長DbSetT就是各個(gè)生產(chǎn)車間。3.1 DbContext數(shù)據(jù)操作的指揮中心DbContext是你與數(shù)據(jù)庫交互的主要入口。它不僅僅是一個(gè)數(shù)據(jù)庫連接的包裝更是一個(gè)功能強(qiáng)大的工作單元Unit of Work和變更跟蹤器Change Tracker的結(jié)合體。工作單元模式這意味著你在一個(gè)DbContext實(shí)例的生命周期內(nèi)通常是一個(gè)Web請求進(jìn)行的多次增刪改查操作會被集中管理。只有當(dāng)你調(diào)用SaveChanges()或SaveChangesAsync()時(shí)所有這些變更才會被一次性、以事務(wù)的方式提交到數(shù)據(jù)庫。這保證了數(shù)據(jù)的一致性。比如你先后添加了一個(gè)用戶和一條該用戶的訂單記錄如果中間某步出錯(cuò)整個(gè)SaveChanges操作會回滾不會出現(xiàn)用戶創(chuàng)建了訂單卻沒記錄的情況。變更跟蹤這是EF的魔法之一。當(dāng)你從數(shù)據(jù)庫查詢出一個(gè)實(shí)體對象后DbContext會記住這個(gè)對象最初的狀態(tài)。之后你在代碼中修改了這個(gè)對象的屬性。當(dāng)你調(diào)用SaveChanges時(shí)EF的變更跟蹤器會對比當(dāng)前狀態(tài)和原始狀態(tài)自動(dòng)生成只更新那些被修改過的字段的SQL語句。你不需要手動(dòng)寫UPDATE ... SET Name新值 WHERE Id1EF幫你高效地完成了。配置與連接管理DbContext也負(fù)責(zé)配置數(shù)據(jù)庫提供程序SQL Server、SQLite、PostgreSQL等、連接字符串以及定義模型的高級配置通過OnModelCreating方法。一個(gè)典型的上下文配置如下public class AppDbContext : DbContext { public AppDbContext(DbContextOptionsAppDbContext options) : base(options) // 依賴注入推薦方式 { } public DbSetUser Users { get; set; } public DbSetOrder Orders { get; set; } protected override void OnModelCreating(ModelBuilder modelBuilder) { // 在這里進(jìn)行Fluent API配置例如定義復(fù)合主鍵、索引等 modelBuilder.EntityUser() .HasIndex(u u.Email) .IsUnique(); // 為Email字段創(chuàng)建唯一索引 } }在ASP.NET Core中我們通常會在Startup.cs或Program.cs中通過依賴注入來配置和獲取DbContext這能更好地管理其生命周期默認(rèn)為Scoped即一次請求一個(gè)實(shí)例。3.2 DbSet 實(shí)體集合的抽象DbSetT代表了數(shù)據(jù)庫中特定表的抽象。你可以把它看作是一個(gè)內(nèi)存中的集合但它的背后是數(shù)據(jù)庫。通過DbSetT你可以執(zhí)行所有的CRUD操作。查詢QueryDbSetT實(shí)現(xiàn)了IQueryableT這是LINQ to Entities的基石。當(dāng)你寫context.Users.Where(u u.Age 18)時(shí)你得到的是一個(gè)IQueryableUser對象。這個(gè)查詢還沒有執(zhí)行它只是一個(gè)表達(dá)式樹。EF會在你需要結(jié)果的時(shí)候例如調(diào)用.ToList()、.FirstOrDefault()或foreach遍歷時(shí)才將這顆表達(dá)式樹翻譯成SQL發(fā)送到數(shù)據(jù)庫執(zhí)行。這種“延遲執(zhí)行”機(jī)制非常高效允許你動(dòng)態(tài)構(gòu)建復(fù)雜的查詢。添加Addcontext.Users.Add(newUser)將一個(gè)新實(shí)體標(biāo)記為“Added”狀態(tài)。此時(shí)它只在內(nèi)存的變更跟蹤器中數(shù)據(jù)庫里還沒有。直到SaveChanges被調(diào)用INSERT語句才會生成并執(zhí)行。更新Update對于已跟蹤的實(shí)體比如剛從數(shù)據(jù)庫查出來的直接修改其屬性即可。對于未跟蹤的實(shí)體比如從HTTP請求反序列化出來的你需要調(diào)用context.Users.Update(existingUser)來將其附加到上下文并標(biāo)記為“Modified”狀態(tài)。刪除Removecontext.Users.Remove(user)將實(shí)體標(biāo)記為“Deleted”狀態(tài)。關(guān)于DbSet的一個(gè)關(guān)鍵理解DbSet并不包含所有數(shù)據(jù)。context.Users本身不代表“Users表中的所有行”它代表的是一個(gè)“針對Users表的查詢?nèi)肟凇?。?dāng)你執(zhí)行context.Users.ToList()才是真的把所有數(shù)據(jù)取到內(nèi)存。在Web應(yīng)用中一定要避免不經(jīng)篩選就直接ToList()大表這會導(dǎo)致全表掃描性能災(zāi)難。正確的做法是始終先通過Where、Take、Skip等操作在數(shù)據(jù)庫端完成過濾和分頁。4. 數(shù)據(jù)建模與關(guān)系配置實(shí)戰(zhàn)定義好實(shí)體類只是第一步如何精確地描述它們之間的關(guān)系和約束才是建模的核心。EF主要通過兩種方式來配置模型數(shù)據(jù)注解Data Annotations和Fluent API。4.1 數(shù)據(jù)注解聲明式的簡單配置數(shù)據(jù)注解是以特性Attribute的方式直接標(biāo)注在實(shí)體類的屬性上。這種方式非常直觀適合簡單的配置。using System.ComponentModel.DataAnnotations; using System.ComponentModel.DataAnnotations.Schema; public class Book { [Key] // 顯式指定主鍵 public int BookId { get; set; } [Required] // 非空約束 [MaxLength(100)] // 最大長度 public string Title { get; set; } [Column(TypeName decimal(18, 2))] // 指定數(shù)據(jù)庫列類型 public decimal Price { get; set; } [ForeignKey(AuthorId)] // 指定外鍵屬性名 public int AuthorId { get; set; } [ForeignKey(AuthorId)] public Author Author { get; set; } // 導(dǎo)航屬性 }數(shù)據(jù)注解的優(yōu)點(diǎn)是清晰、集中一眼就能看到這個(gè)屬性的所有約束。但它也有局限一是配置分散在各個(gè)實(shí)體類中對于復(fù)雜的模型關(guān)系查看起來不夠整體二是有些高級配置如復(fù)合鍵、繼承映射、并發(fā)令牌等用數(shù)據(jù)注解無法實(shí)現(xiàn)或非常別扭。4.2 Fluent API強(qiáng)大而靈活的流式配置Fluent API在DbContext的OnModelCreating方法中配置。它功能更強(qiáng)大是進(jìn)行復(fù)雜、精細(xì)模型配置的首選方式。protected override void OnModelCreating(ModelBuilder modelBuilder) { modelBuilder.EntityBook(entity { // 配置主鍵 entity.HasKey(e e.BookId); // 配置屬性 entity.Property(e e.Title) .IsRequired() .HasMaxLength(100); entity.Property(e e.Price) .HasColumnType(decimal(18, 2)); // 配置一對一關(guān)系 entity.HasOne(e e.Author) .WithMany(a a.Books) // 假設(shè)Author有ICollectionBook Books屬性 .HasForeignKey(e e.AuthorId) .OnDelete(DeleteBehavior.Cascade); // 級聯(lián)刪除作者刪了書也全刪 // 配置索引 entity.HasIndex(e e.Title); entity.HasIndex(e new { e.AuthorId, e.PublishedDate }); // 復(fù)合索引 }); // 配置多對多關(guān)系EF Core 5.0 modelBuilder.EntityBook() .HasMany(b b.Tags) .WithMany(t t.Books) .UsingEntity(j j.ToTable(BookTags)); // 指定連接表名 }Fluent API就像在編寫數(shù)據(jù)庫的Schema定義但用的是C#語法。它能實(shí)現(xiàn)所有數(shù)據(jù)注解的功能并且更多比如精確控制級聯(lián)刪除行為Restrict拒絕刪除、Cascade級聯(lián)刪除、SetNull設(shè)為空等。配置繼承映射策略TPH每層次結(jié)構(gòu)一張表、TPT每類型一張表、TPC每具體類一張表。配置并發(fā)控制使用IsConcurrencyToken()配置行版本或時(shí)間戳字段防止更新沖突。配置值對象Owned Entity Types將某個(gè)復(fù)雜類型映射到主實(shí)體的同一張表中。我的經(jīng)驗(yàn)是對于簡單的字段約束如[Required],[MaxLength]用數(shù)據(jù)注解很方便。但對于關(guān)系配置和任何復(fù)雜的、影響數(shù)據(jù)庫Schema的配置一律使用Fluent API。這樣所有配置都集中在OnModelCreating這一個(gè)地方維護(hù)和查閱起來一目了然更像一份正式的“數(shù)據(jù)契約”。4.3 關(guān)系映射的陷阱與最佳實(shí)踐定義關(guān)系時(shí)有幾個(gè)坑新手很容易掉進(jìn)去循環(huán)引用與序列化如果Author有Books集合Book又有Author導(dǎo)航屬性在通過Web API返回JSON時(shí)序列化器如Newtonsoft.Json或System.Text.Json可能會陷入無限循環(huán)。解決方案是在導(dǎo)航屬性上添加[JsonIgnore]特性或者配置序列化選項(xiàng)忽略循環(huán)引用更優(yōu)雅的方式是使用DTO數(shù)據(jù)傳輸對象來返回?cái)?shù)據(jù)而不是直接返回實(shí)體。延遲加載與N1查詢問題假設(shè)你遍歷所有作者然后打印每個(gè)作者的所有書名var authors context.Authors.ToList(); foreach (var author in authors) { Console.WriteLine(${author.Name}寫了); foreach (var book in author.Books) // 這里會觸發(fā)延遲加載為每個(gè)作者單獨(dú)發(fā)一次查詢 { Console.WriteLine($ - {book.Title}); } }這會導(dǎo)致“N1查詢問題”1次查詢獲取所有作者然后為每個(gè)作者再發(fā)起1次查詢獲取他的書。如果作者有100個(gè)就是101次查詢性能極差。解決方案是使用顯式加載Include或投影查詢Select在第一次查詢時(shí)就加載好關(guān)聯(lián)數(shù)據(jù)// 方法1使用Include顯式加載貪婪加載 var authorsWithBooks context.Authors .Include(a a.Books) .ToList(); // 方法2使用Select投影只取所需數(shù)據(jù)通常更高效 var authorInfo context.Authors .Select(a new { a.Name, BookTitles a.Books.Select(b b.Title).ToList() }) .ToList();外鍵屬性是可選的但推薦顯式定義EF Core可以通過約定推斷出外鍵例如AuthorId但顯式定義一個(gè)AuthorId屬性會讓你的代碼意圖更清晰并且在某些需要直接操作外鍵值的場景下比如批量更新更方便。5. LINQ查詢與數(shù)據(jù)操作全指南EF的強(qiáng)大一半體現(xiàn)在它無縫集成了LINQ。你可以用寫C#集合操作的方式來編寫數(shù)據(jù)庫查詢。5.1 LINQ to Entities查詢基礎(chǔ)LINQ查詢有兩種語法查詢表達(dá)式語法類似SQL和方法語法鏈?zhǔn)秸{(diào)用。方法語法更常用也更靈活。// 方法語法示例 var popularBooks context.Books .Where(b b.Price 50 b.PublishDate.Year 2020) .OrderByDescending(b b.Rating) .ThenBy(b b.Title) .Take(10) .ToList(); // 注意ToList()是觸發(fā)查詢執(zhí)行的地方 // 等效的查詢表達(dá)式語法 var popularBooks2 (from b in context.Books where b.Price 50 b.PublishDate.Year 2020 orderby b.Rating descending, b.Title select b).Take(10).ToList();關(guān)鍵點(diǎn)在于在調(diào)用ToList()、FirstOrDefault()、Count()、Any()等方法之前查詢只是一個(gè)表達(dá)式樹沒有執(zhí)行。這允許你動(dòng)態(tài)構(gòu)建查詢IQueryableBook query context.Books; if (!string.IsNullOrEmpty(searchTitle)) { query query.Where(b b.Title.Contains(searchTitle)); } if (minPrice.HasValue) { query query.Where(b b.Price minPrice.Value); } var finalResult query.OrderBy(b b.Price).ToList();5.2 加載關(guān)聯(lián)數(shù)據(jù)Include與ThenInclude如前所述使用Include來避免N1查詢。// 加載單層關(guān)聯(lián) var blogs context.Blogs .Include(b b.Posts) // 加載Blog的Posts集合 .ToList(); // 加載多層關(guān)聯(lián)嵌套的ThenInclude var blogsWithDetails context.Blogs .Include(b b.Posts) .ThenInclude(p p.Author) // 加載每篇Post的Author .Include(b b.Owner) // 加載Blog的Owner另一個(gè)導(dǎo)航屬性 .ToList();Include是貪婪加載它會將關(guān)聯(lián)的數(shù)據(jù)一次性通過JOIN查詢出來。對于深層或大型關(guān)聯(lián)要小心可能產(chǎn)生的巨大結(jié)果集和“笛卡爾積爆炸”問題。有時(shí)分多次查詢使用Load方法或使用投影Select可能是更好的選擇。5.3 增刪改查與SaveChanges新增var newBlog new Blog { Url http://newblog.com }; context.Blogs.Add(newBlog); // 標(biāo)記為Added // 或者 context.Add(newBlog); DbContext有非泛型Add方法 await context.SaveChangesAsync(); // 執(zhí)行INSERTnewBlog的Id會被數(shù)據(jù)庫自動(dòng)填充更新var blog await context.Blogs.FindAsync(1); // 先查詢出實(shí)體此時(shí)它被上下文跟蹤 if (blog ! null) { blog.Url http://updated.com; // 直接修改屬性 await context.SaveChangesAsync(); // 生成UPDATE語句只更新Url字段 }對于從MVC/API控制器接收的模型未被上下文跟蹤你需要告訴EF這是更新// blogFromClient是從HTTP請求反序列化得到的對象有Id context.Blogs.Update(blogFromClient); // 標(biāo)記整個(gè)實(shí)體為Modified // 或者更精細(xì)地操作 var existingBlog await context.Blogs.FindAsync(blogFromClient.BlogId); context.Entry(existingBlog).CurrentValues.SetValues(blogFromClient); // 只復(fù)制變化的屬性 await context.SaveChangesAsync();刪除var blog await context.Blogs.FindAsync(1); if (blog ! null) { context.Blogs.Remove(blog); await context.SaveChangesAsync(); } // 或者使用簡化刪除無需先查詢但需確保實(shí)體狀態(tài)正確 var blogToDelete new Blog { BlogId 1 }; context.Blogs.Attach(blogToDelete); context.Blogs.Remove(blogToDelete); await context.SaveChangesAsync();SaveChanges的工作原理當(dāng)你調(diào)用它時(shí)EF的變更跟蹤器會檢查所有被跟蹤的實(shí)體找出狀態(tài)為Added、Modified、Deleted的實(shí)體。然后它為這些變更生成相應(yīng)的INSERT、UPDATE、DELETE語句并在一個(gè)事務(wù)中執(zhí)行它們。如果所有語句都成功事務(wù)提交如果任何一條失敗事務(wù)回滾數(shù)據(jù)庫保持原樣并拋出異常。這保證了操作的原子性。5.4 原生SQL與存儲過程雖然LINQ很強(qiáng)但有些復(fù)雜查詢或性能關(guān)鍵路徑你可能需要寫原生SQL。EF Core提供了很好的支持。// 執(zhí)行返回實(shí)體的查詢 var blogs context.Blogs .FromSqlRaw(SELECT * FROM Blogs WHERE Rating {0}, 5) .ToList(); // 執(zhí)行非查詢命令增刪改 var rowsAffected context.Database.ExecuteSqlRaw( UPDATE Blogs SET Rating Rating 1 WHERE BlogId {0}, blogId); // 調(diào)用存儲過程查詢 var blogsFromSp context.Blogs .FromSqlRaw(EXECUTE dbo.GetPopularBlogs minRating{0}, 5) .ToList();使用原生SQL時(shí)務(wù)必使用參數(shù)化查詢像上面例子中用{0}占位符絕對不要用字符串拼接以防止SQL注入攻擊。EF Core會將占位符轉(zhuǎn)換為安全的參數(shù)化查詢。6. 遷移Migration管理數(shù)據(jù)庫的版本控制Code First模式的核心支柱就是遷移。遷移是一組按順序應(yīng)用的、使數(shù)據(jù)庫架構(gòu)與模型保持同步的指令。它就像是數(shù)據(jù)庫的Git。6.1 遷移工作流創(chuàng)建遷移當(dāng)你的實(shí)體類發(fā)生變化新增、修改、刪除在程序包管理器控制臺執(zhí)行Add-Migration [遷移名稱]例如Add-Migration AddBlogRating。EF Core會比較當(dāng)前模型與上一次遷移時(shí)的模型快照生成一個(gè)遷移文件如20250101010101_AddBlogRating.cs里面包含Up和Down方法。Up方法描述如何將數(shù)據(jù)庫升級到新版本Down方法描述如何回退到舊版本。檢查遷移生成的遷移文件是C#代碼你應(yīng)該審查它特別是它生成的SQL操作是否符合預(yù)期。你可以使用Script-Migration命令生成SQL腳本而不執(zhí)行。應(yīng)用遷移Update-Database這個(gè)命令會將所有未應(yīng)用的遷移應(yīng)用到數(shù)據(jù)庫。在開發(fā)環(huán)境這通常直接執(zhí)行。在生產(chǎn)環(huán)境你應(yīng)該使用生成的SQL腳本在可控的數(shù)據(jù)庫部署流程中執(zhí)行?；貪L遷移如果最新遷移有問題可以回滾到上一個(gè)版本Update-Database [上一個(gè)遷移的名稱]或者直接刪除最新的遷移文件確保數(shù)據(jù)庫已回滾或未應(yīng)用然后重新創(chuàng)建。6.2 遷移的常見問題與技巧遷移文件沖突在團(tuán)隊(duì)開發(fā)中如果兩個(gè)人同時(shí)添加了遷移可能會產(chǎn)生沖突。解決方法是先回滾本地未提交的遷移Update-Database到共同祖先拉取隊(duì)友的遷移并應(yīng)用然后重新添加自己的遷移。最好通過團(tuán)隊(duì)規(guī)范來避免同時(shí)添加遷移。自定義遷移SQL有時(shí)自動(dòng)生成的遷移不夠優(yōu)化或者你需要執(zhí)行一些特殊操作如初始化數(shù)據(jù)、創(chuàng)建復(fù)雜索引。你可以在Up方法中直接編寫SQLprotected override void Up(MigrationBuilder migrationBuilder) { migrationBuilder.AddColumnint( name: Rating, table: Blogs, nullable: false, defaultValue: 0); // 自定義SQL為所有老博客設(shè)置一個(gè)初始評分 migrationBuilder.Sql(UPDATE Blogs SET Rating 5 WHERE CreatedDate 2024-01-01); }生產(chǎn)環(huán)境部署千萬不要在生產(chǎn)服務(wù)器上直接運(yùn)行Update-Database。應(yīng)該使用Script-Migration -Idempotent命令生成一個(gè)冪等的SQL腳本。這個(gè)腳本包含了檢查遷移是否已應(yīng)用的邏輯可以安全地在CI/CD管道中或由DBA執(zhí)行。敏感數(shù)據(jù)如連接字符串不要在遷移代碼或DbContext配置中硬編碼連接字符串。應(yīng)該使用配置系統(tǒng)如appsettings.json和用戶機(jī)密開發(fā)時(shí)或環(huán)境變量生產(chǎn)時(shí)來管理。7. 性能優(yōu)化與常見陷阱規(guī)避EF用起來爽但用不好也容易成為性能瓶頸。下面是一些關(guān)鍵的優(yōu)化點(diǎn)和避坑指南。7.1 查詢性能優(yōu)化只選擇需要的字段投影這是最重要的優(yōu)化原則。不要總是Select *。// 不好查詢整個(gè)實(shí)體 var blogs context.Blogs.ToList(); // 好只查詢需要的字段 var blogTitles context.Blogs.Select(b new { b.BlogId, b.Url }).ToList();投影查詢返回的是匿名類型或DTO它們不會被變更跟蹤內(nèi)存占用小傳輸?shù)臄?shù)據(jù)量也少。警惕延遲加載在Web應(yīng)用或服務(wù)中強(qiáng)烈建議顯式關(guān)閉延遲加載。延遲加載會導(dǎo)致不可預(yù)知的數(shù)據(jù)庫查詢N1問題并且通常是在序列化響應(yīng)時(shí)觸發(fā)難以監(jiān)控和調(diào)試。在DbContext配置中設(shè)置LazyLoadingEnabled false并強(qiáng)制自己使用Include或投影。分頁分頁再分頁對于任何可能返回大量數(shù)據(jù)的查詢必須分頁。var pageNumber 1; var pageSize 20; var pagedBlogs context.Blogs .OrderBy(b b.BlogId) .Skip((pageNumber - 1) * pageSize) .Take(pageSize) .ToList();使用Skip和Take在數(shù)據(jù)庫端完成分頁而不是把所有數(shù)據(jù)取到內(nèi)存再分片。使用異步方法為了不阻塞線程提高應(yīng)用吞吐量盡量使用ToListAsync()、FirstOrDefaultAsync()、SaveChangesAsync()等異步方法。7.2 變更跟蹤與上下文生命周期DbContext不是單例DbContext設(shè)計(jì)為輕量級、短生命周期的對象。在ASP.NET Core中默認(rèn)注冊為Scoped生命周期每個(gè)請求一個(gè)實(shí)例。絕對不要將其注冊為Singleton否則變更跟蹤器會積累大量實(shí)體導(dǎo)致內(nèi)存泄漏和并發(fā)問題。適時(shí)使用AsNoTracking對于只讀查詢?nèi)绻愦_定后續(xù)不會修改這些實(shí)體并調(diào)用SaveChanges使用AsNoTracking可以顯著提升查詢性能因?yàn)镋F不會為這些實(shí)體建立變更跟蹤快照。var readOnlyBlogs context.Blogs.AsNoTracking().Where(b b.Rating 4).ToList();批量操作優(yōu)化EF Core 7.0 對批量更新和刪除提供了更好的支持ExecuteUpdate和ExecuteDelete它們會生成一條SQL語句而不是先查詢再逐條操作。// 傳統(tǒng)方式低效先查詢再循環(huán)修改最后SaveChanges // var blogs context.Blogs.Where(b b.Rating 3).ToList(); // foreach(var b in blogs) b.Rating 3; // context.SaveChanges(); // 高效批量更新EF Core 7.0 await context.Blogs .Where(b b.Rating 3) .ExecuteUpdateAsync(setters setters.SetProperty(b b.Rating, 3)); // 高效批量刪除 await context.Blogs .Where(b b.CreatedDate.Year 2020) .ExecuteDeleteAsync();對于大量數(shù)據(jù)的插入考慮使用DbContext的AddRange并合理設(shè)置SaveChanges的批次大小DbContextOptionsBuilder可以配置MaxBatchSize或者使用像SqlBulkCopy這樣的專門工具。7.3 日志與監(jiān)控打開EF Core的日志記錄是了解其背后做了什么、發(fā)現(xiàn)性能問題的關(guān)鍵。// 在DbContext配置中啟用簡單日志開發(fā)環(huán)境 optionsBuilder.UseSqlServer(connectionString) .LogTo(Console.WriteLine, LogLevel.Information); // 將日志輸出到控制臺 // 或者在ASP.NET Core中使用ILogger optionsBuilder.UseSqlServer(connectionString) .LogTo((message) logger.LogInformation(message), LogLevel.Information);查看日志你可以看到EF生成的SQL語句、執(zhí)行時(shí)間、參數(shù)等。特別注意那些“重復(fù)查詢”和“查詢了過多不必要字段”的日志。8. 實(shí)戰(zhàn)構(gòu)建一個(gè)簡單的博客系統(tǒng)數(shù)據(jù)層讓我們把上面的知識串起來快速構(gòu)建一個(gè)博客系統(tǒng)的核心數(shù)據(jù)層。假設(shè)我們有Blog,Post,Comment,Tag實(shí)體。第一步定義實(shí)體public class Blog { public int BlogId { get; set; } [Required, MaxLength(200)] public string Url { get; set; } public int Rating { get; set; } 0; public DateTime CreatedDate { get; set; } DateTime.UtcNow; // 導(dǎo)航屬性 public ListPost Posts { get; set; } new ListPost(); } public class Post { public int PostId { get; set; } [Required, MaxLength(500)] public string Title { get; set; } public string Content { get; set; } public DateTime PublishedDate { get; set; } public bool IsPublished { get; set; } public int BlogId { get; set; } public Blog Blog { get; set; } public ListComment Comments { get; set; } new ListComment(); public ListTag Tags { get; set; } new ListTag(); } public class Comment { public int CommentId { get; set; } public string Author { get; set; } public string Content { get; set; } public DateTime CreatedAt { get; set; } DateTime.UtcNow; public int PostId { get; set; } public Post Post { get; set; } } public class Tag { public int TagId { get; set; } [Required, MaxLength(50)] public string Name { get; set; } public ListPost Posts { get; set; } new ListPost(); }第二步配置DbContext和關(guān)系public class BloggingContext : DbContext { public BloggingContext(DbContextOptionsBloggingContext options) : base(options) { } public DbSetBlog Blogs { get; set; } public DbSetPost Posts { get; set; } public DbSetComment Comments { get; set; } public DbSetTag Tags { get; set; } protected override void OnModelCreating(ModelBuilder modelBuilder) { // Blog 配置 modelBuilder.EntityBlog(entity { entity.HasKey(e e.BlogId); entity.HasIndex(e e.Url).IsUnique(); entity.Property(e e.Url).IsRequired().HasMaxLength(200); }); // Post 配置 modelBuilder.EntityPost(entity { entity.HasKey(e e.PostId); entity.Property(e e.Title).IsRequired().HasMaxLength(500); entity.Property(e e.PublishedDate).HasDefaultValueSql(GETUTCDATE()); // SQL Server語法 // Post - Blog (多對一) entity.HasOne(p p.Blog) .WithMany(b b.Posts) .HasForeignKey(p p.BlogId) .OnDelete(DeleteBehavior.Cascade); // 博客刪除文章也刪除 // Post - Tags (多對多) entity.HasMany(p p.Tags) .WithMany(t t.Posts) .UsingEntity(j j.ToTable(PostTags)); }); // Comment 配置 modelBuilder.EntityComment(entity { entity.HasKey(e e.CommentId); // Comment - Post (多對一) entity.HasOne(c c.Post) .WithMany(p p.Comments) .HasForeignKey(c c.PostId) .OnDelete(DeleteBehavior.Cascade); // 文章刪除評論也刪除 }); // Tag 配置 modelBuilder.EntityTag(entity { entity.HasKey(e e.TagId); entity.HasIndex(e e.Name).IsUnique(); // 標(biāo)簽名唯一 entity.Property(e e.Name).IsRequired().HasMaxLength(50); }); } }第三步在Program.cs中注冊服務(wù)var builder WebApplication.CreateBuilder(args); // 從配置中讀取連接字符串 var connectionString builder.Configuration.GetConnectionString(DefaultConnection); // 注冊DbContext使用SQL Server builder.Services.AddDbContextBloggingContext(options options.UseSqlServer(connectionString) .LogTo(Console.WriteLine, LogLevel.Information) // 開發(fā)時(shí)看SQL日志 ); var app builder.Build(); // ... 中間件配置 app.Run();第四步創(chuàng)建并應(yīng)用初始遷移在程序包管理器控制臺確保默認(rèn)項(xiàng)目是你的數(shù)據(jù)層項(xiàng)目Add-Migration InitialCreate Update-Database第五步在服務(wù)中使用public class BlogService { private readonly BloggingContext _context; public BlogService(BloggingContext context) { _context context; } public async TaskListBlogSummaryDto GetPopularBlogsAsync(int topN) { // 使用投影查詢只取所需數(shù)據(jù)避免N1 var blogs await _context.Blogs .Where(b b.Rating 3) .OrderByDescending(b b.Rating) .Take(topN) .Select(b new BlogSummaryDto { BlogId b.BlogId, Url b.Url, PostCount b.Posts.Count(p p.IsPublished) // 在數(shù)據(jù)庫端計(jì)數(shù) }) .AsNoTracking() // 只讀不跟蹤 .ToListAsync(); return blogs; } public async Task AddPostToBlogAsync(int blogId, CreatePostDto newPost) { // 假設(shè)newPost包含Title, Content, TagIds var post new Post { Title newPost.Title, Content newPost.Content, BlogId blogId, IsPublished true, PublishedDate DateTime.UtcNow }; // 處理多對多關(guān)系關(guān)聯(lián)標(biāo)簽 if (newPost.TagIds?.Any() true) { var tags await _context.Tags .Where(t newPost.TagIds.Contains(t.TagId)) .ToListAsync(); post.Tags.AddRange(tags); } _context.Posts.Add(post); await _context.SaveChangesAsync(); } }這個(gè)簡單的例子涵蓋了實(shí)體定義、復(fù)雜關(guān)系配置一對多、多對多、Fluent API使用、依賴注入、查詢優(yōu)化投影、AsNoTracking以及服務(wù)層操作。從這里出發(fā)你可以根據(jù)業(yè)務(wù)需求不斷增加新的實(shí)體和復(fù)雜的查詢邏輯。記住EF是一個(gè)強(qiáng)大的工具但理解其原理和最佳實(shí)踐才能讓它真正為你的項(xiàng)目賦能而不是成為負(fù)擔(dān)。