EF Core添加关联已有Team的Playlist报唯一键重复错误如何解决

你当前的Team和Playlist的一对多关系配置符合需求：允许Playlist不关联Team，删除Team时不会级联删除关联的Playlist，TeamName的唯一键约束也没有问题。唯一可以优化的点是建议在Playlist实体中显式添加外键字段，避免EF Core依赖阴影属性处理关联时出现不可预期的跟踪问题。

你遇到的报错本质原因是：调用Add方法新增Playlist时，EF Core识别到关联的Team实例处于Detached未跟踪状态，会默认将Team标记为Added待新增，触发了TeamName的唯一键冲突。你之前设置EntityState无效大概率是时机不对或者AutoMapper映射时生成了新的Team实例，下面给两类可行方案：

方案1：添加显式外键（推荐，性能最优、最稳定） #

第一步修改Playlist实体，补充和Team主键类型一致的外键字段：

public class Playlist: AuditEntity
{
    // 原有属性不变
    public string PlayListName { get; set; }
    public string Description { get; set; }

    // 新增显式外键，类型和Team的Id属性保持一致，如果你的Id是string就改成string?
    public Guid? TeamId { get; set; }
    public Team Team { get; set; }
}

第二步调整业务代码，不需要查询完整的Team实体，直接赋值外键即可：

PlaylistDTO dto = new PlaylistDTO();
dto.Name = "new playlist with related team";
// 直接把前端传过来的id赋值给外键字段
dto.TeamId = id;
Playlist storeToDb = _mapper.Map<Playlist>(dto);
_context.Playlists.Add(storeToDb);
                    
await _context.SaveChangesAsync();

该方案完全规避了关联实体的跟踪问题，还减少了一次查询Team的数据库请求。

方案2：不改动实体结构，修复跟踪逻辑 #

如果暂时不想调整实体结构，可以修改业务代码手动控制跟踪状态：

调整方式1：手动设置Team的跟踪状态 #

PlaylistDTO dto = new PlaylistDTO();
dto.Name = "new playlist with related team";
dto.Team = _context.Team.FirstOrDefault(t => t.Id == id);
Playlist storeToDb = _mapper.Map<Playlist>(dto);
_context.Playlists.Add(storeToDb);
// Add执行后手动把关联的Team标记为未修改，EF就不会尝试插入新Team
_context.Entry(storeToDb.Team).State = EntityState.Unchanged;
await _context.SaveChangesAsync();

调整方式2：避免AutoMapper生成新的Team实例 #

如果上面的方式还是报错，说明AutoMapper映射时创建了新的Team副本，没有复用你查询到的已跟踪实例，改为手动赋值Team即可：

var team = _context.Team.FirstOrDefault(t => t.Id == id);
PlaylistDTO dto = new PlaylistDTO();
dto.Name = "new playlist with related team";
// 映射时忽略Team导航属性
Playlist storeToDb = _mapper.Map<Playlist>(dto);
// 手动赋值已被当前上下文跟踪的Team实例
storeToDb.Team = team;
_context.Playlists.Add(storeToDb);
await _context.SaveChangesAsync();

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