Xcode 14中sqlite3_open_v2误将目录名当作文件名的问题排查

Xcode 14 的核心变化 #

Xcode 14 升级了内置的 SQLite 库至 3.38.0 及以上版本，该版本调整了 sqlite3_open_v2 的路径处理逻辑：当传入的路径标记为目录但实际不存在，且调用时带有 SQLITE_OPEN_CREATE 标志时，旧版 SQLite（Xcode 13 内置版本）会直接返回 SQLITE_CANTOPEN（错误码14），而新版 SQLite 会将该路径当作文件名创建新的数据库文件，不再校验路径的目录标记。

配置 sqlite3_open_v2 拒绝目录路径 #

要让 sqlite3_open_v2 在传入目录路径（无论是否存在）时返回错误，可以通过以下两种方式实现：

方式一：使用 SQLite URI 模式并添加 dir=fail 参数 #

你之前尝试的 SQLITE_OPEN_URI 标志需要配合 dir=fail 参数才能生效，具体修改代码如下：

let temp = URL(fileURLWithPath: NSTemporaryDirectory(), isDirectory: true)
dbURL = temp.appendingPathComponent(UUID().uuidString, isDirectory: true)
// 拼接URI参数，强制SQLite在路径为目录时返回错误
let dbURI = dbURL.absoluteString + "?dir=fail"
var connectionPointer: OpaquePointer?
let flags = SQLITE_OPEN_CREATE | SQLITE_OPEN_READWRITE | SQLITE_OPEN_FULLMUTEX | SQLITE_OPEN_URI
let code = sqlite3_open_v2(dbURI, &connectionPointer, flags, nil)
if code != SQLITE_OK {
   throw SQLError.lastError(in: connectionPointer!)
}

• 原理：在URI模式下，dir=fail 参数会告诉SQLite，若目标路径是已存在的目录，或试图将目录路径当作文件创建，直接返回错误。

方式二：提前通过文件系统API校验路径 #

在调用 sqlite3_open_v2 前，先检查目标路径是否为已存在的目录：

let temp = URL(fileURLWithPath: NSTemporaryDirectory(), isDirectory: true)
dbURL = temp.appendingPathComponent(UUID().uuidString, isDirectory: true)

// 提前校验路径是否为目录
var isDirectory: ObjCBool = false
if FileManager.default.fileExists(atPath: dbURL.path, isDirectory: &isDirectory), isDirectory.boolValue {
    throw SQLError(code: 14, message: "unable to open database file")
}

var connectionPointer: OpaquePointer?
let flags = SQLITE_OPEN_CREATE | SQLITE_OPEN_READWRITE | SQLITE_OPEN_FULLMUTEX
let code = sqlite3_open_v2(dbURL.absoluteString, &connectionPointer, flags, nil)
if code != SQLITE_OK {
   throw SQLError.lastError(in: connectionPointer!)
}

• 优点：不依赖SQLite的URI模式，直接通过系统API做前置校验，逻辑更直观。

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