EF Core 循环引用本质是导航属性自动补全导致对象图闭环，序列化时默认抛异常；解决方式包括全局配置忽略循环、按需用[JsonIgnore]、投影为DTO或设计阶段避免双向导航。
EF Core 中的循环引用问题，本质是导航属性自动补全导致对象图形成闭环，比如
包含
集合，而每个
又反向引用
。序列化（尤其是返回 JSON 给
前端
）时，
或
默认拒绝处理这种结构，直接抛异常。
全局配置序列化器忽略循环
这是最常用、一劳永逸的方式，适用于大多数 API 场景。
用
System.Text.Json
（.NET 5+ 默认）：在
（或旧版
）中配置
services.AddControllers().AddJsonOptions(options => {options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;});
用
Newtonsoft.Json
（需安装
包）：
services.AddControllers().AddNewtonsoftJson(options => {options.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;});
按需忽略特定导航属性
更精准、更安全，适合只希望“断开某条链”的情况，比如不需要把
序列化出去。
对
：加
特性到导航属性上
public class Post{public int Id { get; set; }public string Title { get; set; }public int BlogId { get; set; }[JsonIgnore]public Blog Blog { get; set; }}
php版微信js-sdk支付接口类
php版微信js-sdk支付接口类
下载
对
：同样用
，效果一致
用投影（Select）替代实体直接返回
不序列化实体本身，而是转成匿名对象或 DTO，天然避开导航属性和循环风险。
推荐用于 API 接口层，语义清晰且性能更好
var blogs = context.Blogs.Include(b => b.Posts).Select(b => new{Id = b.Id,Name = b.Name,PostCount = b.Posts.Count,Posts = b.Posts.Select(p => new { p.Id, p.Title })}).ToList();
避免双向导航建模（设计阶段）
如果业务上真不需要反向访问，建模时就不要定义双向导航属性。
例如只保留
，去掉
或保留
外键，但不声明
导航属性
这样既没循环，又不影响查询（仍可用
加载）
基本上就这些。选哪种方式取决于你的场景：全局配置省事，DTO 最可控，删导航最彻底。不复杂但容易忽略的是——别只改序列化，忘了检查模型设计本身是否真的需要双向关联。
BlogPostsPostBlogSystem.Text.JsonNewtonsoft.JsonProgram.csStartup.csMicrosoft.AspNetCore.Mvc.NewtonsoftJsonPost.BlogSystem.Text.Json[JsonIgnore]Newtonsoft.Json[JsonIgnore]Blog.PostsPost.BlogPost.BlogIdPost.BlogInclude