导入XLS数据时EF Core出现Transaction实体跟踪冲突问题求助

问题场景 #

从XLS文件读取交易数据，要求仅在数据库不存在对应记录时执行插入操作。XLS文件本身包含重复数据，已通过判断逻辑尝试避免重复添加，但仍出现实体跟踪冲突错误。

相关代码 #

DB操作代码 #

foreach (var transaction in transactions)
{
    if (!_dbContext.Transactions.Any(t =>
        t.TransactionDate.Date == transaction.TransactionDate.Date &&
        t.ValueDate.Date == transaction.ValueDate.Date &&
        t.Balance == transaction.Balance &&
        t.ChequeNumber!.Trim() == transaction.ChequeNumber!.Trim() &&
        t.TransactionRemarks.Trim() == transaction.TransactionRemarks.Trim() &&
        t.WithdrawalAmount == transaction.WithdrawalAmount &&
        t.DepositAmount == transaction.DepositAmount))
    {
        _dbContext.Transactions.Add(transaction);
    }
}
await _dbContext.SaveChangesAsync();

DBContext配置 #

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);

    modelBuilder.Entity<Transaction>()
    .HasKey(t => new {
        t.TransactionDate,
        t.ValueDate,
        t.Balance,
        t.ChequeNumber,
        t.TransactionRemarks,
        t.WithdrawalAmount,
        t.DepositAmount
    });
}

Transaction模型 #

public class Transaction
{
    [NotMapped]
    public int SNo { get; set; }
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int ID { get; set; }
    public DateTime ValueDate { get; set; }
    public DateTime TransactionDate { get; set; }
    public string? ChequeNumber { get; set; }
    public string TransactionRemarks { get; set; } = string.Empty;
    public decimal? WithdrawalAmount { get; set; }
    public decimal? DepositAmount { get; set; }
    public decimal Balance { get; set; }
}

错误信息 #

The instance of entity type 'Transaction' cannot be tracked because another instance with the same key value for {'TransactionDate', 'ValueDate', 'Balance', 'ChequeNumber', 'TransactionRemarks', 'WithdrawalAmount', 'DepositAmount'} is already being tracked.

问题原因 #

1. 本地数据未去重：XLS文件中的重复数据未在内存中过滤，导致循环中多次尝试添加主键完全相同的实体到上下文，而EF Core的跟踪机制不允许同时跟踪同主键的多个实体实例。
2. 判断逻辑与主键定义不一致：
   • 主键使用TransactionDate和ValueDate的完整DateTime值（包含时分秒），但判断数据库是否存在时仅比较.Date部分，可能导致逻辑误判。
   • 字符串字段（ChequeNumber、TransactionRemarks）在判断时使用了Trim()，但主键定义使用原始未修剪值，进一步加剧逻辑不一致，可能导致实际主键不同的被误判为重复，或主键相同的未被正确过滤。

解决方案 #

步骤1：预处理XLS数据，确保本地无重复 #

读取XLS后，先对字符串字段做修剪，并过滤内存中的重复记录：

// 先修剪字符串字段
foreach (var trans in transactions)
{
    trans.ChequeNumber = trans.ChequeNumber?.Trim();
    trans.TransactionRemarks = trans.TransactionRemarks.Trim();
}

// 过滤本地重复数据（.NET 6+ 可用DistinctBy）
var uniqueTransactions = transactions.DistinctBy(t => new {
    t.TransactionDate,
    t.ValueDate,
    t.Balance,
    t.ChequeNumber,
    t.TransactionRemarks,
    t.WithdrawalAmount,
    t.DepositAmount
}).ToList();

步骤2：修正数据库存在性判断逻辑 #

让判断逻辑与主键定义完全一致，避免使用.Date和额外Trim()（因为已预处理数据）：

foreach (var transaction in uniqueTransactions)
{
    if (!_dbContext.Transactions.Any(t =>
        t.TransactionDate == transaction.TransactionDate &&
        t.ValueDate == transaction.ValueDate &&
        t.Balance == transaction.Balance &&
        t.ChequeNumber == transaction.ChequeNumber &&
        t.TransactionRemarks == transaction.TransactionRemarks &&
        t.WithdrawalAmount == transaction.WithdrawalAmount &&
        t.DepositAmount == transaction.DepositAmount))
    {
        _dbContext.Transactions.Add(transaction);
    }
}
await _dbContext.SaveChangesAsync();

可选优化：调整主键定义（按需） #

如果业务上仅需要按日期（不含时间）判断唯一性，可以修改主键定义，只取日期部分：

modelBuilder.Entity<Transaction>()
.HasKey(t => new {
    TransactionDate = t.TransactionDate.Date,
    ValueDate = t.ValueDate.Date,
    t.Balance,
    t.ChequeNumber,
    t.TransactionRemarks,
    t.WithdrawalAmount,
    t.DepositAmount
});

注意：此修改需要配合数据库迁移，且要确保模型中存储的日期时间的时分秒不影响业务逻辑。

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