使用Fluent API设置主键时遇重复DocumentId的技术问题

我来给你梳理几种实际项目里常用的解决方案，对应你遇到的「设置DocumentId为主键但会收到重复实例」的场景：

方案1：新增自增代理主键，放开DocumentId的主键限制 #

如果你的业务允许存在多条相同DocumentId的Message记录，那最直接的办法是给Message加一个自增的独立主键，把DocumentId改成普通字段（如果后续需要保证DocumentId唯一性，也可以加唯一索引，但根据你的描述当前可能不需要）。

第一步：修改Message模型 #

public class Message
{
    // 新增自增主键，让SQL自动生成唯一值
    public int Id { get; set; }
    
    [Required]
    public Guid DocumentId { get; set; }
    
    [Required]
    public int Size { get; set; }
    
    public string SenderId { get; set; }
}

第二步：用Fluent API配置 #

modelBuilder.Entity<Message>()
    .HasKey(m => m.Id) // 把新增的Id设为主键
    .Property(m => m.Id)
    .UseIdentityColumn(); // 配置成SQL的自增列（SQL Server用IDENTITY，MySQL用AUTO_INCREMENT）

// 如果你后续又需要保证DocumentId的唯一性，可以加这行（现在不需要就注释掉）
// modelBuilder.Entity<Message>().HasIndex(m => m.DocumentId).IsUnique();

这样一来，哪怕收到相同DocumentId的实例，数据库也能正常插入，因为每条记录的主键Id都是唯一的自增值。

方案2：保留DocumentId为主键，用「插入或更新」逻辑处理重复 #

如果你的业务逻辑是：收到重复DocumentId的Message时，更新现有记录的内容（比如Size、SenderId）而不是插入新记录，那可以用EF Core的Upsert功能（EF Core 7及以上版本支持），或者直接写SQL的合并语句。

用EF Core 7+的Upsert示例 #

// 假设你拿到了一条新的Message实例
var incomingMessage = new Message 
{ 
    DocumentId = existingDocId, 
    Size = 2048, 
    SenderId = "user_456" 
};

// 执行Upsert：匹配DocumentId，存在就更新，不存在就插入
await dbContext.Messages
    .Upsert(incomingMessage)
    .On(m => m.DocumentId)
    .UpdateExisting(m => new Message 
    { 
        Size = incomingMessage.Size, 
        SenderId = incomingMessage.SenderId 
    })
    .RunAsync();

手动执行SQL语句（以SQL Server为例） #

如果你用的EF版本较低，或者更倾向于直接写SQL，可以用MERGE语句：

MERGE INTO Messages AS Target
USING (VALUES (@DocumentId, @Size, @SenderId)) AS Source (DocumentId, Size, SenderId)
ON Target.DocumentId = Source.DocumentId
WHEN MATCHED THEN
    UPDATE SET Size = Source.Size, SenderId = Source.SenderId
WHEN NOT MATCHED THEN
    INSERT (DocumentId, Size, SenderId) VALUES (Source.DocumentId, Source.Size, Source.SenderId);

方案3：设置复合主键（仅适用于有其他唯一标识字段的场景） #

如果除了DocumentId，还有其他字段（比如SenderId、消息时间戳）能和它组合成唯一标识，那可以把这几个字段设为复合主键：

modelBuilder.Entity<Message>()
    .HasKey(m => new { m.DocumentId, m.SenderId }); // 假设DocumentId+SenderId的组合是唯一的

不过这个方案局限性比较大，只有当你能确保组合字段绝对唯一时才适用，否则还是前两个方案更稳妥。

一般来说，方案1是最通用的解决办法，既能解决重复插入的问题，又不影响后续的业务扩展；如果有更新重复记录的需求，方案2会更贴合业务逻辑。

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