iOS应用接入SQLite数据库路径配置异常 真机运行库为空问题求助

1 初始代码路径错误的原因 #

你最初写入本地绝对路径能正常运行，是因为该路径是你开发环境Mac本地的文件路径，仅在调试阶段能被模拟器访问。iOS App运行在独立沙盒中，FileManager.default.currentDirectoryPath 在沙盒环境下并不会指向你的项目文件夹，正式打包或运行真机时固定的绝对路径必然失效。

2 调整后真机数据库为空的核心原因 #

你调整后的复制逻辑本身是合理的，真机空库基本由以下几个配置疏漏导致：

• 你的 Model.sqlite 没有被加入App的构建目标：选中项目中的 Model.sqlite 文件，查看Xcode右侧检查器的「Target Membership」板块，必须勾选你的App主目标，否则打包时该文件不会被塞入App的Bundle包，Bundle.main.url 会返回空，你现有代码中未处理该异常，会直接跳过复制逻辑，自动创建一个空的数据库，最终表现为真机数据为空。
• 你之前在真机上运行过旧版本代码，沙盒目录中已经生成了一个空的 Model.sqlite 文件，你的判断逻辑 if !FileManager.default.fileExists 会直接跳过复制步骤，一直沿用旧的空库。
• 补充优化建议：建议将数据库存到Library目录而非Documents目录，Documents目录默认会被iCloud自动备份，预制的静态数据库不需要备份，改用Library目录更符合苹果存储规范。

修正后参考代码 #

struct PersistenceController {
    static let shared = PersistenceController()
    let container: NSPersistentContainer
    
    init() {
        container = NSPersistentContainer(name: "Model")
        let dbName = "Model.sqlite"
        let dbUrl = getLibraryDirectory().appendingPathComponent(dbName)
        
        // 数据库不存在时从Bundle复制预制库
        if !FileManager.default.fileExists(atPath: dbUrl.path) {
            // 显式判断预制库是否存在，避免静默失败
            guard let bundleDbUrl = Bundle.main.url(forResource: "Model", withExtension: "sqlite") else {
                fatalError("预制数据库未加入构建目标，请检查Target Membership配置")
            }
            do {
                try FileManager.default.copyItem(at: bundleDbUrl, to: dbUrl)
            } catch {
                fatalError("复制数据库失败：\(error.localizedDescription)")
            }
        }
        
        container.persistentStoreDescriptions = [NSPersistentStoreDescription(url: dbUrl)]
        container.loadPersistentStores(completionHandler: { (storeDescription, error) in
            if let error = error as NSError? {
                fatalError("加载数据库失败：\(error), \(error.userInfo)")
            }
        })
    }
    
    func getLibraryDirectory() -> URL {
        let paths = FileManager.default.urls(for: .libraryDirectory, in: .userDomainMask)
        return paths[0]
    }
}

必做验证步骤 #

• 确认 Model.sqlite 的Target Membership已经勾选App主目标
• 完全删除真机/模拟器上已安装的旧版App，重新运行即可正常加载预制数据

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