ASP.NET Core API POST请求处理EF Core多对多关联循环报错如何解决

问题原因说明 #

你的报错来自两个核心点：

1. ASP.NET Core 默认的System.Text.Json序列化返回结果时，Coctails关联的Ingredients对象里又包含CoctailsWithThisIngredient导航属性反指回鸡尾酒列表，触发无限循环序列化报错
2. 你当前的新增接口逻辑有问题，直接Attach前端传入的实体，会把已存在的配料当成新对象尝试插入数据库，引发额外的逻辑错误

解决方案 #

1. 配置序列化忽略循环引用（无需修改实体，完全满足保留多对多导航属性的需求） #

直接在项目的Program.cs中配置控制器的JSON序列化规则，忽略循环引用即可：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 忽略序列化时的循环引用
        options.JsonSerializerOptions.ReferenceHandler = System.Text.Json.Serialization.ReferenceHandler.IgnoreCycles;
        // 可选配置：属性名不强制驼峰匹配，适配你前端传的coctailIngredients小写开头
        options.JsonSerializerOptions.PropertyNameCaseInsensitive = true;
    });

这个配置不会影响EF Core的多对多映射规则，你保留的两个导航属性仍然可以正常让EF自动生成中间关联表。

2. 修复新增鸡尾酒接口逻辑（必改，避免重复插入配料） #

你当前接口直接Attach前端传入的实体，没有处理已存在的配料，逻辑错误，修改为以下逻辑：

[HttpPost]
public async Task<ActionResult<Coctails>> PostCoctails(Coctails coctails)
{
    var trackedIngredients = new List<Ingredients>();
    foreach (var inputIng in coctails.CoctailIngredients)
    {
        // 从数据库查询已存在的配料
        var existIng = await _context.Ingredients
            .FirstOrDefaultAsync(i => i.Name.Equals(inputIng.Name, StringComparison.OrdinalIgnoreCase));
        if (existIng == null)
        {
            return BadRequest($"配料 {inputIng.Name} 未在系统中登记，请先新增配料");
        }
        trackedIngredients.Add(existIng);
    }
    // 替换为EF上下文已追踪的配料对象
    coctails.CoctailIngredients = trackedIngredients;
    // 新增鸡尾酒用Add，Attach仅适用于已存在于数据库的实体
    _context.Coctails.Add(coctails);
    await _context.SaveChangesAsync();

    return CreatedAtAction("GetCoctails", new { id = coctails.CoctailsId }, coctails);
}

3. 生产环境推荐方案：使用DTO隔离实体模型 #

如果要从根源避免循环引用，同时避免暴露实体的敏感字段，可以单独定义输入输出DTO（数据传输对象），输出DTO中不包含反指的导航属性，实体层仍保留两个导航属性供EF映射使用，搭配AutoMapper做对象映射即可。

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