数据库保存时外键约束FK_ViewDocumentAudit_UploadedDocuments冲突如何解决

INSERT 语句触发外键约束冲突的核心原因是：你插入ViewDocumentAudit表时带入的DocumentId值，在关联的父表UploadedDocuments的Id列中不存在。外键约束要求子表的外键字段值必须是父表对应主键字段中已有的有效值，不允许插入父表不存在的关联值。

INSERT语句与外键约束“FK_ViewDocumentAudit_UploadedDocuments”冲突。该冲突发生在数据库“Butler”的“dbo.UploadedDocuments”表的“Id”列，语句已终止。

• 第一步：验证parsedDocumentId的实际值
  调试或者加日志输出插入前parsedDocumentId的真实值，确认该值是否是你预期的合法文档ID，排除参数传错、类型解析错误（比如字符串转int时溢出、出错得到无效值）的问题。
• 第二步：校验关联父表是否存在对应记录
  在数据库中直接执行查询SELECT * FROM dbo.UploadedDocuments WHERE Id = [你要插入的DocumentId值]，确认是否有返回结果，如果没有返回则说明该文档ID确实不存在，问题出在参数合法性上。
• 第三步：检查EF实体外键映射是否正确
  确认ViewDocumentAudit实体的DocumentId是否正确关联到UploadedDocument的主键Id：如果是注解配置，检查UploadedDocument导航属性是否加了[ForeignKey("DocumentId")]标记；如果是Fluent API配置，检查关联语句是否把外键字段配错。

• 方案1：插入前增加外键合法性校验
  在插入审计记录前先判断关联的用户、文档是否存在，避免无效数据插入，代码示例如下：

  public static void ViewDocumentAudit(long userId, int parsedDocumentId)
  {
      using (Entities dbContext = new Entities())
      {
           // 校验文档ID是否存在
           if (!dbContext.UploadedDocuments.Any(d => d.Id == parsedDocumentId))
           {
               // 可根据业务需求记录日志或抛出自定义业务异常
               throw new ArgumentException($"文档ID {parsedDocumentId} 不存在", nameof(parsedDocumentId));
           }
           // 校验用户ID是否存在
           if (!dbContext.Users.Any(u => u.Id == userId))
           {
               throw new ArgumentException($"用户ID {userId} 不存在", nameof(userId));
           }
           
           ViewDocumentAudit auditObject = new ViewDocumentAudit();
           auditObject.UserId = userId;
           auditObject.DocumentId = parsedDocumentId;
           auditObject.DateAccessed = DateTime.Now;
  
           dbContext.ViewDocumentAudits.Add(auditObject);
           dbContext.SaveChanges();
       }
  }
  

• 方案2：修正EF实体映射配置
  如果是外键关联配错导致的问题，给导航属性补充外键注解即可，修改后的实体示例如下：

  public partial class ViewDocumentAudit
  {
      public long Id { get; set; }
      public long UserId { get; set; }
      public int DocumentId { get; set; }
      public System.DateTime DateAccessed { get; set; }
  
      [ForeignKey(nameof(DocumentId))]
      public virtual UploadedDocument UploadedDocument { get; set; }
      [ForeignKey(nameof(UserId))]
      public virtual user user { get; set; }
  }
  

• 方案3：修复上游参数逻辑
  如果排查发现是上游parsedDocumentId解析/传参错误，比如把其他字段值赋值给了文档ID、字符串转int时出错，直接修正上游的参数生成逻辑即可。

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