该错误源于ef core上下文对相同主键实体的重复跟踪或状态冲突。需检查实体是否已被跟踪、正确区分add()与attach()用途、避免跨上下文复用实体，并确保主键生成策略与赋值行为一致。
这个错误通常出现在你尝试将一个已存在主键值的实体添加到 DbContext 时，EF Core 发现该实体类型已被跟踪（或与当前上下文存在状态冲突），但又不符合新增逻辑——比如主键非自增却手动设了值，或重复 Attach/Entry 操作。
检查实体是否已被跟踪
EF Core 同一上下文中不能同时跟踪两个相同主键的实体实例。如果你先查询过某条记录，再 new 一个同 ID 的实体并调用 Add()，就会触发此错误。
- 用 context.Entry(entity).State 查看当前实体状态（如 Detached、Added、Unchanged）
- 用 context.ChangeTracker.Entries().Any(e => e.Entity == entity) 判断是否已跟踪
- 必要时调用 context.Entry(entity).State = EntityState.Detached 主动解除跟踪
区分 Add() 和 Attach() 的使用场景
Add() 适用于全新实体（预期插入），EF Core 默认设为 Added 状态；Attach() 适用于已存在于数据库的实体（预期更新或忽略），默认设为 Unchanged。
- 若要插入新数据且主键由数据库生成（如 IDENTITY），确保主键属性为 0 或 null，再用 Add()
- 若主键是手动赋值（如 GUID、业务编码），且确定数据库中尚不存在，仍可用 Add()，但需确认无重复跟踪
- 若只是想更新某条记录，请先 Attach() 再修改属性，或直接 Find() + 修改 + SaveChanges()
避免跨上下文复用实体对象
从一个 DbContext 查询出的实体，不要直接传给另一个 DbContext 实例调用 Add() 或 Attach() —— 它可能携带原始跟踪信息或引发状态混乱。
- 推荐做法：只传递关键字段（如 ID、Name），在新上下文中重新构造实体
- 或使用 AsNoTracking() 查询，确保返回的是“干净”的未跟踪对象
- 也可用 context.Entry(entity).State = EntityState.Detached 在传递前主动剥离
主键配置与值设置不一致
例如模型中配置了 [DatabaseGenerated(DatabaseGeneratedOption.None)]，但你又没给主键赋值，或赋了 0；又或者用了 ValueGeneratedOnAdd() 却手动设置了主键。
- 检查 Fluent API 或 Data Annotation 中主键生成策略是否匹配实际赋值行为
- 对自增主键，插入前不要设置主键值（让 EF Core 留空）
- 对非自增主键（如雪花 ID、GUID），确保每次插入前都显式赋唯一值
基本上就这些。核心是理清实体生命周期和上下文跟踪机制，不复杂但容易忽略。
