SwiftUI问题：模拟器可找到文件，iOS设备无法找到文件

嘿，我之前也帮开发者解决过一模一样的问题——模拟器能正常连接数据库，真机却找不到，核心原因其实很明确：模拟器的Documents目录里的数据库大概率是你手动放进去的，但真机的沙箱是封闭的，不会自动同步这个操作。而你尝试复制文件失败，大概率是踩了几个常见的配置或代码小坑，咱们一步步来搞定：

一、先确认数据库文件真的被打包进了App Bundle #

这是最容易忽略的环节，很多人以为拖进Xcode就完事了，其实不然：

• 找到你项目里的Database.db文件，选中它
• 看右侧的File Inspector面板，找到Target Membership区域，确保你的主App Target是被勾选的（没勾的话，文件根本不会被打包到App里）
• 也可以去Product > Build Phases > Copy Bundle Resources里检查，确认Database.db在这个列表里

二、修复复制文件的代码逻辑 #

你的复制代码有两个小问题：一是没检查目标文件是否已经存在，重复复制会直接报错；二是路径拼接可以更简洁。修改后的代码如下：

func copyFileToDocumentsFolder(nameForFile: String, extForFile: String) {
    let fileManager = FileManager.default
    // 获取Documents目录的URL
    guard let documentsURL = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first else {
        print("没法获取Documents目录哦")
        return
    }
    // 目标文件的完整URL
    let destURL = documentsURL.appendingPathComponent("\(nameForFile).\(extForFile)")
    
    // 先检查文件是否已经存在，避免重复复制报错
    if fileManager.fileExists(atPath: destURL.path) {
        print("数据库已经在Documents里了，不用再复制啦")
        return
    }
    
    // 从App Bundle里找源文件
    guard let sourceURL = Bundle.main.url(forResource: nameForFile, withExtension: extForFile) else {
        print("Bundle里找不到Database.db！检查下文件有没有正确添加到项目里")
        return
    }
    
    do {
        // 执行复制
        try fileManager.copyItem(at: sourceURL, to: destURL)
        print("数据库复制成功～")
    } catch {
        print("复制失败了，错误详情：\(error.localizedDescription)")
    }
}

三、正确的数据库连接流程 #

一定要先执行复制操作，确保Documents里有数据库文件，再尝试连接：

// 先复制文件（如果需要的话）
copyFileToDocumentsFolder(nameForFile: "Database", extForFile: "db")

// 再连接数据库
guard let documentsPath = NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true).first else {
    fatalError("获取Documents目录失败")
}
let dbPath = "\(documentsPath)/Database.db"
do {
    let db = try Connection(dbPath)
    print("数据库连接成功！")
} catch {
    fatalError("连接数据库失败：\(error.localizedDescription)")
}

四、如果还是不行，试试这些排查步骤 #

• 清理Xcode缓存：按下Cmd+Shift+K清理Build Folder，然后重新编译运行，有时候缓存会搞鬼
• 验证Bundle里的文件：可以加一行print(Bundle.main.path(forResource: "Database", ofType: "db"))，如果输出nil，那肯定是文件没正确添加到Bundle里
• 检查真机权限：iOS 14+对沙箱权限要求更严，但Documents是App的私有目录，正常不需要额外权限，不过可以确认你的App没有开启特殊的沙箱限制（比如在Info.plist里加了不必要的权限配置）

最后再提醒一句：模拟器的沙箱目录是可以手动访问修改的，但真机不行，所有文件都得通过App代码或者iCloud同步这类方式放进Documents，别想着手动拷贝啦。

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