SwiftData中如何分离Movie与Favorite实体存储避免更新冲突？

核心思路 #

将Movie和Favorite实体分离到独立的存储文件，同时实现影片库（movies.store）的版本化更新逻辑，确保更新影片库时不丢失用户收藏数据：

• Movie实体：绑定到独立的只读存储文件，仅用于展示影片列表，支持版本化更新
• Favorite实体：绑定到单独的读写存储文件，专门保存用户收藏数据，不受影片库更新影响

具体实现步骤 #

1. 版本化管理影片库文件 #

将Bundle中的影片库文件添加版本标识，比如命名为movies_v1.store、movies_v2.store，后续更新时递增版本号，方便判断是否需要替换Documents中的旧文件。

2. 分离两个实体的存储配置 #

创建两个独立的ModelConfiguration，分别指定不同的存储URL和读写权限：

• 给Movie配置设置只读权限，避免误修改影片库数据
• 给Favorite配置使用单独的存储文件，保持读写权限

3. 实现影片库更新逻辑 #

通过偏好设置记录当前Documents中影片库的版本号，启动时对比Bundle中最新版本的影片库：

• 如果Bundle版本更高，则替换Documents中的旧影片库文件
• 更新偏好设置中的版本号，确保下次启动不再重复替换

修改后的完整代码 #

import SwiftUI
import SwiftData

@main
struct MoviesApp: App {
    private let movieStoreVersionKey = "MovieStoreCurrentVersion"
    // 当前Bundle中影片库的版本号，更新时修改此处
    private let latestMovieStoreVersion = "2"
    private let movieStoreBaseName = "movies"
    private let favoriteStoreName = "favorites"
    
    var modelContainer: ModelContainer = {
        let fileManager = FileManager.default
        let documentDirectoryURL: URL
        
        do {
            documentDirectoryURL = try fileManager.url(for: .documentDirectory, in: .userDomainMask, appropriateFor: nil, create: false)
        } catch {
            fatalError("Failed to get document directory: \(error)")
        }
        
        // --------------------------
        // 处理Movie实体的存储与更新
        // --------------------------
        let bundleMovieURL = Bundle.main.url(forResource: "\(movieStoreBaseName)_v\(latestMovieStoreVersion)", withExtension: "store")!
        let documentMovieURL = documentDirectoryURL.appendingPathComponent("\(movieStoreBaseName).store")
        let defaults = UserDefaults.standard
        
        // 检查是否需要更新影片库
        let currentVersion = defaults.string(forKey: movieStoreVersionKey) ?? "0"
        if currentVersion < latestMovieStoreVersion {
            // 删除旧的影片库文件（如果存在）
            if fileManager.fileExists(atPath: documentMovieURL.path) {
                try? fileManager.removeItem(at: documentMovieURL)
            }
            // 复制新版本的影片库到Documents
            do {
                try fileManager.copyItem(at: bundleMovieURL, to: documentMovieURL)
                defaults.set(latestMovieStoreVersion, forKey: movieStoreVersionKey)
            } catch {
                fatalError("Failed to update movie store: \(error)")
            }
        } else if !fileManager.fileExists(atPath: documentMovieURL.path) {
            // 首次启动，复制初始影片库
            do {
                try fileManager.copyItem(at: bundleMovieURL, to: documentMovieURL)
                defaults.set(latestMovieStoreVersion, forKey: movieStoreVersionKey)
            } catch {
                fatalError("Failed to copy initial movie store: \(error)")
            }
        }
        
        // 创建Movie实体的只读配置
        let movieConfig = ModelConfiguration(
            for: Movie.self,
            url: documentMovieURL,
            isReadOnly: true
        )
        
        // --------------------------
        // 处理Favorite实体的存储
        // --------------------------
        let favoriteURL = documentDirectoryURL.appendingPathComponent("\(favoriteStoreName).store")
        let favoriteConfig = ModelConfiguration(
            for: Favorite.self,
            url: favoriteURL
        )
        
        // 初始化包含两个配置的ModelContainer
        do {
            return try ModelContainer(
                for: Movie.self, Favorite.self,
                configurations: [movieConfig, favoriteConfig]
            )
        } catch {
            fatalError("Could not create ModelContainer: \(error)")
        }
    }()

    var body: some Scene {
        WindowGroup {
            MainView()
        }
        .modelContainer(modelContainer)
    }
}

代码说明 #

• 版本化更新：通过latestMovieStoreVersion控制影片库版本，每次更新Bundle中的影片库时，只需递增该版本号，启动时自动替换旧文件
• 只读影片库：movieConfig设置isReadOnly: true，确保影片列表数据不会被意外修改
• 独立收藏存储：favoriteConfig使用单独的favorites.store文件，完全独立于影片库，更新影片库时不会影响收藏数据
• 首次启动兼容：同时处理首次启动复制初始影片库和版本更新两种场景

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