如何调试Core Data在context.save()时发生的唯一约束冲突崩溃？

问题背景 #

我有一个名为Score的Core Data实体，用于表示每日分数，包含date: Double（某一天的午夜时间戳）和score: Double两个属性，已为date字段添加唯一约束。执行以下代码时，在context.save()步骤崩溃，报错信息为：Constraint unique violation: UNIQUE constraint failed: ZSCORE.ZDATE

实现代码 #

let dispatchGroup = DispatchGroup()

var factor1: Double = 0
var factor2: Double = 0
var factor3: Double = 0

dispatchGroup.enter()
calculateFactor1(date: date) { score in
    factor1 = score
    dispatchGroup.leave()
}

dispatchGroup.enter()
calculateFactor2(date: date) { score in
    factor2 = score
    dispatchGroup.leave()
}

dispatchGroup.enter()
calculateFactor3(date: date) { score in
    factor3 = score
    dispatchGroup.leave()
}

dispatchGroup.notify(queue: .main) {
    let mainScore = factor1 + factor2 + factor3
    let scoreObject = Score(context: self.context)
    scoreObject.date = date
    scoreObject.score = mainScore
    
    do {
        try self.context.save()
        completion()
    }
    catch {
        completion()
    }
}

调试与解决步骤 #

• 直接验证数据库已有数据
  崩溃的核心是你要插入的date对应的记录已经存在。打开应用沙盒里的sqlite数据库（可以用Xcode的Data Inspector，或者第三方Core Data查看工具），找到ZSCORE表，检查是否已有ZDATE值等于当前传入date的记录。

• 检查代码调用是否重复触发
  这段保存逻辑可能被多次调用，导致同一个date被重复插入。在dispatchGroup.notify闭包开头加一行打印：print("准备保存日期：\(date)")，运行时观察控制台，看是否出现重复的日期输出。

• 修改逻辑：先查询再操作（插入/更新）
  既然date是唯一约束，正确的做法是先查询该日期是否已有记录，有则更新，无则插入：

  dispatchGroup.notify(queue: .main) {
      let mainScore = factor1 + factor2 + factor3
      
      // 先查询已有记录
      let fetchRequest: NSFetchRequest<Score> = Score.fetchRequest()
      fetchRequest.predicate = NSPredicate(format: "date == %@", NSNumber(value: date))
      
      do {
          let existingRecords = try self.context.fetch(fetchRequest)
          if let existingScore = existingRecords.first {
              // 更新已有记录的分数
              existingScore.score = mainScore
          } else {
              // 插入新记录
              let scoreObject = Score(context: self.context)
              scoreObject.date = date
              scoreObject.score = mainScore
          }
          try self.context.save()
          completion()
      } catch {
          print("保存/更新失败：\(error)")
          completion()
      }
  }
  

• 完善错误处理，避免崩溃原因被掩盖
  原代码的catch块直接调用completion()，没有任何错误日志，很难定位问题。至少要打印错误信息，方便排查：

  catch {
      print("Core Data操作失败：\(error.localizedDescription)")
      completion()
  }
  

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