如何在System.Text.Json反序列化时将同ID的多个Author对象映射为同一实例以解决EF Core跟踪冲突

这个问题我之前也遇到过——当JSON里重复出现同ID的实体时，默认的JSON反序列化（不管是Newtonsoft.Json还是System.Text.Json）都会为每个JSON对象生成新的实例，刚好踩中EF Core的规则：同一键值的实体只能被上下文跟踪一次。下面给你几个可行的解决方案，你可以根据自己的场景选择：

方法1：自定义JSON转换器（以Newtonsoft.Json为例） #

核心思路是在反序列化过程中维护一个缓存字典，只要遇到相同Id的Author，就直接复用之前创建的实例，而不是生成新的。

实现自定义转换器 #

public class AuthorConverter : JsonConverter<Author>
{
    // 用字典缓存已创建的Author实例，Key为Id
    private readonly Dictionary<string, Author> _authorCache = new Dictionary<string, Author>();

    public override Author ReadJson(JsonReader reader, Type objectType, Author existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        // 先常规反序列化出Author对象
        var author = serializer.Deserialize<Author>(reader);
        if (author == null || string.IsNullOrEmpty(author.Id))
            return author;

        // 检查缓存，存在则返回缓存实例，否则存入缓存
        if (_authorCache.TryGetValue(author.Id, out var cachedAuthor))
            return cachedAuthor;

        _authorCache.Add(author.Id, author);
        return author;
    }

    public override void WriteJson(JsonWriter writer, Author value, JsonSerializer serializer)
    {
        // 序列化逻辑保持默认即可
        serializer.Serialize(writer, value);
    }
}

使用转换器反序列化 #

// 配置JsonSerializerSettings，添加自定义转换器
var jsonSettings = new JsonSerializerSettings();
jsonSettings.Converters.Add(new AuthorConverter());

// 反序列化JSON到Book对象，此时同ID的Author会指向同一实例
var book = JsonConvert.DeserializeObject<Book>(jsonContent, jsonSettings);

方法2：反序列化后手动合并实例 #

如果不想修改反序列化逻辑，可以先完成常规反序列化，再手动遍历替换重复的Author实例。

实现合并逻辑 #

// 先常规反序列化Book
var book = JsonConvert.DeserializeObject<Book>(jsonContent);
var authorCache = new Dictionary<string, Author>();

// 先把主作者加入缓存
if (book.Author != null)
{
    authorCache[book.Author.Id] = book.Author;
}

// 遍历Reviewers列表，替换重复的Author实例
for (int i = 0; i < book.Reviewers.Count; i++)
{
    var currentReviewer = book.Reviewers[i];
    if (authorCache.TryGetValue(currentReviewer.Id, out var cachedAuthor))
    {
        // 替换为缓存中的实例
        book.Reviewers[i] = cachedAuthor;
    }
    else
    {
        // 新的Author，加入缓存
        authorCache[currentReviewer.Id] = currentReviewer;
    }
}

方法3：借助EF Core上下文提前关联实体 #

如果你的场景是直接将反序列化后的对象存入数据库，可以先把所有Author提取出来，提前加入EF上下文让其跟踪，再反序列化Book——EF会自动将JSON中的Author引用关联到上下文已跟踪的实例。

实现步骤 #

using (var context = new YourDbContext())
{
    // 先解析JSON对象，提取所有Author
    var jsonObject = JObject.Parse(jsonContent);
    var mainAuthor = jsonObject["author"].ToObject<Author>();
    var reviewers = jsonObject["reviewers"].ToObject<List<Author>>();

    // 收集所有Author并按Id去重（避免重复加入上下文）
    var allUniqueAuthors = new List<Author> { mainAuthor }
        .Concat(reviewers)
        .GroupBy(a => a.Id)
        .Select(g => g.First()) // 这里可以根据需求选择保留哪个版本（比如第一个或最新的）
        .ToList();

    // 将去重后的Author加入上下文，让EF跟踪
    foreach (var author in allUniqueAuthors)
    {
        // 如果是已有实体用Attach，新增用Add；或者用Upsert处理新增/更新
        context.Authors.Attach(author);
        // EF Core 7.0+支持Upsert：context.Authors.Upsert(author).On(a => a.Id).Run();
    }

    // 反序列化Book，此时EF会自动关联上下文里的Author实例
    var book = jsonObject.ToObject<Book>();
    context.Books.Add(book);
    context.SaveChanges();
}

注意事项 #

• 如果JSON中同ID的Author属性不一致（比如同一个Id的Name字段不同），你需要在代码中处理冲突逻辑（比如保留第一个实例的属性，或者合并属性），否则会出现数据不一致的问题。
• 如果你用的是System.Text.Json，自定义转换器的逻辑类似，只需要继承JsonConverter<Author>并实现Read和Write方法即可。

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