Como Resolver o Erro de Entity Tracking no Entity Framework Core

System.InvalidOperationException: 
The instance of entity type 'Produto' cannot be tracked because another instance 
with the same key value for {'Id'} is already being tracked. 
When attaching existing entities, ensure that only one entity instance 
with a given key value is attached.

public class Produto
{
    public int Id { get; set; }
    public string Nome { get; set; }
    public decimal Preco { get; set; }
    public int CategoriaId { get; set; }
    public Categoria Categoria { get; set; }
}

[HttpPut("{id}")]
public async Task AtualizarProduto(int id, Produto produtoAtualizado)
{
    // 1. Carrega o produto existente
    var produtoExistente = await _context.Produtos
        .Include(p => p.Categoria)
        .FirstOrDefaultAsync(p => p.Id == id);

    // 2. Tenta atualizar os valores
    produtoExistente.Nome = produtoAtualizado.Nome;
    produtoExistente.Preco = produtoAtualizado.Preco;
    produtoExistente.Categoria = produtoAtualizado.Categoria; // <- PROBLEMA AQUI!

    // 3. Salva
    await _context.SaveChangesAsync(); // BUM! Exceção de tracking!
}

? ERRO: System.InvalidOperationException: 
The instance of entity type 'Categoria' cannot be tracked because another instance 
with the key value '{Id: 5}' is already being tracked.

[HttpPut("{id}")]
public async Task AtualizarProduto(int id, Produto produtoAtualizado)
{
    // 1. Carrega o produto do banco
    var produtoExistente = await _context.Produtos
        .Include(p => p.Categoria)
        .FirstOrDefaultAsync(p => p.Id == id);

    if (produtoExistente == null)
        return NotFound();

    // 2. Atualiza APENAS as propriedades que vieram na requisição
    // NÃO atribui a Categoria inteira — apenas o Id
    produtoExistente.Nome = produtoAtualizado.Nome;
    produtoExistente.Preco = produtoAtualizado.Preco;
    produtoExistente.CategoriaId = produtoAtualizado.CategoriaId;

    // 3. Salva
    await _context.SaveChangesAsync();

    return Ok(produtoExistente);
}

? SUCESSO: Produto atualizado com sucesso! 
Nenhum conflito de tracking porque usamos a mesma instância rastreada.

// Consulta para exibição (NÃO vai modificar)
public async Task> ListarProdutos()
{
    // AsNoTracking() previne tracking desnecessário
    return await _context.Produtos
        .AsNoTracking()
        .Include(p => p.Categoria)
        .ToListAsync();
}

? SUCESSO: 150 produtos retornados.
Nenhuma entidade foi rastreada. Memória otimizada!

public async Task SubstituirProduto(Produto produtoNovo)
{
    // 1. Verifica se a entidade já está sendo rastreada
    var entrada = _context.Entry(produtoNovo);
    
    if (entrada.State != EntityState.Detached)
    {
        // 2. Desanexa a entidade antiga
        entrada.State = EntityState.Detached;
        Console.WriteLine($"?? Entidade {produtoNovo.Id} desanexada.");
    }

    // 3. Anexa como modificada
    _context.Update(produtoNovo);
    Console.WriteLine($"?? Entidade {produtoNovo.Id} anexada como Modified.");

    // 4. Salva
    await _context.SaveChangesAsync();
    Console.WriteLine($"? Produto {produtoNovo.Id} salvo com sucesso!");
}

?? Entidade 42 desanexada.
?? Entidade 42 anexada como Modified.
? Produto 42 salvo com sucesso!

public async Task AtualizarProdutoComSetValues(Produto produtoAtualizado)
{
    // 1. Carrega a entidade rastreada
    var produtoOriginal = await _context.Produtos
        .FirstOrDefaultAsync(p => p.Id == produtoAtualizado.Id);

    if (produtoOriginal == null)
    {
        Console.WriteLine($"? Produto {produtoAtualizado.Id} não encontrado.");
        return;
    }

    Console.WriteLine($"?? Produto original: {produtoOriginal.Nome} (R$ {produtoOriginal.Preco})");

    // 2. Aplica os novos valores à instância rastreada
    _context.Entry(produtoOriginal).CurrentValues.SetValues(produtoAtualizado);

    Console.WriteLine($"?? Valores atualizados: {produtoAtualizado.Nome} (R$ {produtoAtualizado.Preco})");

    // 3. Salva
    await _context.SaveChangesAsync();

    Console.WriteLine($"? Produto {produtoOriginal.Id} atualizado com sucesso!");
}

?? Produto original: Teclado Mecânico (R$ 350,00)
?? Valores atualizados: Teclado Mecânico RGB (R$ 399,00)
? Produto 42 atualizado com sucesso!

// Configure no DbContext
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder
        .UseSqlServer("Server=localhost;Database=MeuDB;")
        .EnableSensitiveDataLogging() // ATENÇÃO: APENAS EM DESENVOLVIMENTO!
        .LogTo(Console.WriteLine);
}

// Agora a mensagem de erro mostra o valor exato:
// "The instance of entity type 'Categoria' cannot be tracked because 
// another instance with the key value '{Id: 5}' is already being tracked."

?? Atenção

Ative o logging sensitivo apenas em desenvolvimento. Nunca em produção, pois ele pode expor dados sensíveis como senhas e chaves privadas.