SwiftData一对一关系更新报错：跨上下文关联对象非法

错误根源 #

你遇到的Illegal attempt to establish a relationship between objects in different contexts错误，本质是Swift Data中关联的两个对象属于不同的ModelContext：

• 当upsertShow返回已存在的LocalShow时，该对象可能来自独立的查询上下文；
• 新创建的LocalWatchlistItem/LocalReview通过database.insert插入到另一个上下文；
• 跨上下文的对象无法建立关联，因此触发错误。

另外，重复创建剧集的问题，是因为没有利用@Attribute(.unique)约束执行正确的upsert逻辑，而是直接创建新对象导致违反唯一键规则。

修正方案 #

方案1：统一操作上下文（推荐） #

确保所有查询、更新、创建操作在同一个ModelContext中完成，彻底避免跨上下文关联问题。

1. 重构upsertShow方法

func upsertShow(_ show: Show, in context: ModelContext) throws -> LocalShow {
    // 基于唯一id查询当前上下文内的剧集
    let fetchDescriptor = FetchDescriptor<LocalShow>(predicate: #Predicate { $0.id == show.key })
    if let existingShow = try context.fetch(fetchDescriptor).first {
        // 更新现有剧集属性
        existingShow.updatedAt = .now
        existingShow.title = show.title
        // ...其他属性更新
        return existingShow
    } else {
        // 创建新剧集并加入当前上下文
        let newShow = LocalShow(
            id: show.key,
            createdAt: .now,
            updatedAt: nil,
            title: show.title,
            // ...其他属性赋值
        )
        context.insert(newShow)
        return newShow
    }
}

2. 修改追剧项与影评创建方法

func addToWatchlist(_ show: Show, in context: ModelContext) throws -> LocalWatchlistItem {
    let upsertedShow = try upsertShow(show, in: context)
    let watchlistItem = LocalWatchlistItem(show: upsertedShow)
    context.insert(watchlistItem)
    // 可选：立即持久化修改
    // try context.save()
    return watchlistItem
}

func createReview(for show: Show, rating: Int, comment: String?, in context: ModelContext) throws -> LocalReview {
    let upsertedShow = try upsertShow(show, in: context)
    let review = LocalReview(show: upsertedShow, rating: rating, comment: comment)
    context.insert(review)
    // 可选：立即持久化修改
    // try context.save()
    return review
}

方案2：利用Swift Data内置upsert功能（iOS 17+/macOS 14+） #

通过Swift Data原生的upsert能力，基于唯一键自动处理“存在则更新，不存在则插入”逻辑，代码更简洁：

func upsertShow(_ show: Show, in context: ModelContext) throws -> LocalShow {
    let newShow = LocalShow(
        id: show.key,
        createdAt: .now,
        updatedAt: .now,
        title: show.title,
        // ...其他属性赋值
    )
    // 基于唯一id执行upsert
    try context.insert(newShow, updating: .all)
    
    // 查询返回当前上下文内的对象（确保关联时使用同一上下文实例）
    let fetchDescriptor = FetchDescriptor<LocalShow>(predicate: #Predicate { $0.id == show.key })
    guard let upsertedShow = try context.fetch(fetchDescriptor).first else {
        throw NSError(domain: "ShowUpsertError", code: -1, userInfo: [NSLocalizedDescriptionKey: "剧集upsert失败"])
    }
    return upsertedShow
}

关键注意事项 #

• 所有涉及对象关联的操作必须在**同一个ModelContext**中完成，禁止跨上下文传递对象；
• 依赖@Attribute(.unique)约束保证剧集id的唯一性，从根源避免重复创建；
• 若需要立即将修改写入磁盘，需调用try context.save()，否则修改仅存在于内存上下文内。

内容的提问来源于stack exchange，提问作者Curt Orion-Indev