ef core 循环引用本质是导航属性自动补全导致对象图闭环，序列化时默认抛异常；解决方式包括全局配置忽略循环、按需用[jsonignore]、投影为dto或设计阶段避免双向导航。
EF Core 中的循环引用问题，本质是导航属性自动补全导致对象图形成闭环，比如 Blog 包含 Posts 集合，而每个 Post 又反向引用 Blog。序列化（尤其是返回 JSON 给前端）时，System.Text.Json 或 Newtonsoft.Json 默认拒绝处理这种结构，直接抛异常。
全局配置序列化器忽略循环
这是最常用、一劳永逸的方式，适用于大多数 API 场景。
- 用 System.Text.Json（.NET 5+ 默认）：在
Program.cs（或旧版Startup.cs）中配置
services.AddControllers()
.AddJsonOptions(options => {
options.JsonSerializerOptions.ReferenceHandler = ReferenceHandler.IgnoreCycles;
});
- 用 Newtonsoft.Json（需安装
Microsoft.AspNetCore.Mvc.NewtonsoftJson包）：
services.AddControllers()
.AddNewtonsoftJson(options => {
options.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;
});
按需忽略特定导航属性
更精准、更安全，适合只希望“断开某条链”的情况，比如不需要把 Post.Blog 序列化出去。
- 对
System.Text.Json：加[JsonIgnore]特性到导航属性上
public class Post
{
public int Id { get; set; }
public string Title { get; set; }
public int BlogId { get; set; }
[JsonIgnore]
public Blog Blog { get; set; }
}
- 对
Newtonsoft.Json：同样用[JsonIgnore]，效果一致
用投影（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();
避免双向导航建模（设计阶段）
如果业务上真不需要反向访问，建模时就不要定义双向导航属性。
- 例如只保留
Blog.Posts，去掉Post.Blog - 或保留
Post.BlogId外键，但不声明Post.Blog导航属性 - 这样既没循环，又不影响查询（仍可用
Include加载）
基本上就这些。选哪种方式取决于你的场景：全局配置省事，DTO 最可控，删导航最彻底。不复杂但容易忽略的是——别只改序列化，忘了检查模型设计本身是否真的需要双向关联。
