EF Core实体关系构建及JSON自引用循环异常问题排查

嘿，我来帮你搞定这个自引用循环的问题！你遇到的JsonSerializationException本质是实体之间的双向关联（比如Post关联User，User又关联Post集合）在序列化时形成了循环引用，而且你之前配置的全局Json序列化规则没有作用到手动序列化的代码上。下面给你几个可行的解决方案：

方案1：手动序列化时指定忽略循环引用 #

你当前用Newtonsoft.Json.JsonConvert.SerializeObject手动序列化数据，但Mvc的AddJsonOptions配置只对框架自动处理的序列化生效（比如直接返回Json(posts)）。所以需要在手动序列化时显式传入配置：

public IActionResult GetAllPost()
{
    var posts = _ctx.Posts
        .Include(u => u.User)
        .ToList();
    
    // 手动创建序列化设置，忽略循环引用
    var serializeSettings = new Newtonsoft.Json.JsonSerializerSettings
    {
        ReferenceLoopHandling = Newtonsoft.Json.ReferenceLoopHandling.Ignore
    };
    
    return Json(Newtonsoft.Json.JsonConvert.SerializeObject(posts, serializeSettings));
}

方案2：改用Mvc内置的JsonResult（推荐） #

其实你不需要手动调用JsonConvert.SerializeObject，直接返回Json(posts)就会自动使用你在ConfigureServices里配置的序列化规则，这样更简洁：

public IActionResult GetAllPost()
{
    var posts = _ctx.Posts
        .Include(u => u.User)
        .ToList();
    
    // 直接返回JsonResult，会应用全局配置的ReferenceLoopHandling.Ignore
    return Json(posts);
}

这个方法最省事，和你已有的配置完全匹配，不需要额外修改序列化代码。

方案3：使用DTO（数据传输对象）避免循环引用（更优雅） #

如果想从根源上避免循环引用，同时精确控制返回给前端的数据（比如不返回敏感的Password字段），推荐定义DTO类，只包含需要展示的字段：

首先定义DTO：

// Post数据传输对象
public class PostDto
{
    public int PostUID { get; set; }
    public string Title { get; set; }
    public string Description { get; set; }
    public int Likes { get; set; }
    public DateTime CreateOn { get; set; }
    public DateTime LastEditOn { get; set; }
    public UserDto User { get; set; }
}

// User数据传输对象
public class UserDto
{
    public int UserUID { get; set; }
    public string UserName { get; set; }
    public string Email { get; set; }
    // 不要包含Posts/Comments集合，避免循环引用
}

然后在查询时映射到DTO：

public IActionResult GetAllPost()
{
    var posts = _ctx.Posts
        .Include(p => p.User)
        .Select(p => new PostDto
        {
            PostUID = p.PostUID,
            Title = p.Title,
            Description = p.Description,
            Likes = p.Likes,
            CreateOn = p.CreateOn,
            LastEditOn = p.LastEditOn,
            User = new UserDto
            {
                UserUID = p.User.UserUID,
                UserName = p.User.UserName,
                Email = p.User.Email
            }
        })
        .ToList();
    
    return Json(posts);
}

这种方式不仅解决了循环引用问题，还能减少不必要的数据传输，同时避免泄露敏感信息（比如你的User实体里的Password字段不会被返回），是生产环境中更推荐的做法。

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