iOS项目使用SQLite.swift创建SQLite文件报错无法打开如何解决

• 核心原因为数据库路径构造不规范：直接使用字符串拼接构造路径的方式容错率极低，当系统返回的 Documents 目录字符串末尾自带/、或部分 iOS 版本沙盒路径编码存在特殊字符时，会导致最终生成的数据库路径不合法，SQLite 底层无法识别并打开对应文件
• 少见触发原因：首次启动创建数据库时，若当前App沙盒的 Documents 目录存在权限异常（比如测试设备开启了高级别的文件保护、debug 过程中沙盒目录被手动篡改），也会触发该类报错

优先使用 URL 格式构造路径，避免字符串拼接带来的格式问题，推荐写法如下：

do {
    // 以URL格式获取Documents目录，避免字符串路径的格式异常
    let docURL = try FileManager.default.url(
        for: .documentDirectory,
        in: .userDomainMask,
        appropriateFor: nil,
        create: false
    )
    // 拼接数据库文件名，系统会自动处理路径分隔符
    let dbURL = docURL.appendingPathComponent("db.sqlite3")
    let db = try Connection(dbURL.path)
    // 后续正常执行数据库操作
} catch {
    print("数据库初始化失败详情：\(error)")
}

如果修改路径构造逻辑后仍存在报错，可按以下步骤排查：

• 打印最终的数据库绝对路径，打开Xcode设备沙盒工具查看对应路径是否存在，若目录不存在可先调用FileManager的createDirectory方法手动创建Documents目录，再初始化数据库
• 检查项目Info.plist中的文件保护等级，如果设置了NSFileProtectionComplete，可调整为NSFileProtectionCompleteUntilFirstUserAuthentication，避免设备锁屏状态下无法访问数据库文件
• 若代码运行在App Extension（如Widget、通知扩展）中，不能直接访问主App的Documents目录，需开启App Group使用共享目录存储数据库文件

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