C#保存多对多关联实体遇自引用循环异常，求解决方案

问题场景 #

现有EF实体类定义如下（多对多关系通过中间表BookCategory实现）：

public class Book
{
    public int BookId { get; set; }
    public string Title { get; set; }
    public virtual ICollection<BookCategory> BookCategories { get; set; }
}

public class Category
{
    public int CategoryId { get; set; }
    public string CategoryName { get; set; }
    public virtual ICollection<BookCategory> BookCategories { get; set; }
}

public class BookCategory
{
    [Key, Column(Order = 1)]
    public int BookId { get; set; }
    [Key, Column(Order = 2)]
    public int CategoryId { get; set; }
    public Book Book { get; set; }
    public Category Category { get; set; }
}

通过以下代码获取跟踪状态的Book实体并修改：

var book = _dbContext.Book
                .Include(b => b.BookCategories)
                .AsTracking()
                .FirstOrDefault(e => e.BookId == bookId);

// 修改标题并替换关联的分类集合
book.Title = "New Title";
book.BookCategories = model.Categories.Select
                      (c => 
                           new BookCategory{
                           BookId = c.Id,
                           CategoryId = c.CategoryId
                      }).ToList();

调用_dbContext.SaveChanges()时抛出循环引用序列化异常：

Self referencing loop detected with type 'Entities.BookCategory'. 
Path 'Before.BookCategory[0].Category.BookCategory[0].Book.BookCategory'.

问题原因 #

1. 直接替换BookCategories集合会导致EF上下文对原有关联实体的跟踪状态混乱，同时新创建的BookCategory对象未正确关联导航属性，引发Book→BookCategory→Category→BookCategory→Book的循环引用链。
2. 异常本质是序列化操作（通常是EF的变更日志或第三方拦截器触发）遇到了循环引用的对象图。

最优解决方案 #

正确的做法是先清理原有关联，再添加新关联，而非直接替换集合，同时避免不必要的导航属性赋值：

var book = _dbContext.Book
                .Include(b => b.BookCategories)
                .AsTracking()
                .FirstOrDefault(e => e.BookId == bookId);

// 更新书籍标题
book.Title = "New Title";

// 1. 移除现有的所有BookCategory关联
book.BookCategories.Clear();

// 2. 添加新的关联，仅设置外键，EF会自动关联跟踪的Book实体
foreach (var categoryModel in model.Categories)
{
    book.BookCategories.Add(new BookCategory
    {
        CategoryId = categoryModel.CategoryId
        // 无需手动设置BookId，EF会通过当前跟踪的book自动填充
    });
}

// 保存变更
_dbContext.SaveChanges();

额外优化（可选） #

如果需要彻底避免循环引用序列化问题，可以通过以下两种方式处理：

• 全局配置Newtonsoft.Json忽略循环引用：

// 在Startup或服务配置中添加
services.AddMvc()
    .AddNewtonsoftJson(options =>
        options.SerializerSettings.ReferenceLoopHandling = Newtonsoft.Json.ReferenceLoopHandling.Ignore);

• 在实体类标记忽略导航属性序列化：

public class BookCategory
{
    [Key, Column(Order = 1)]
    public int BookId { get; set; }
    [Key, Column(Order = 2)]
    public int CategoryId { get; set; }
    
    [JsonIgnore]
    public Book Book { get; set; }
    
    [JsonIgnore]
    public Category Category { get; set; }
}

内容的提问来源于stack exchange，提问作者Saurabh Soni