承接上一篇,先快速盤點 FMDB 的組成:
FMDB 最值得研究的地方就在多執行緒處理,而新版本主要靠 FMDatabaseQueue 來解決。本篇就從這個類下手。
- (void)FMDatabaseQueueTest {
NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName = [doc stringByAppendingPathComponent:@"students.sqlite"];
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:fileName];
[queue inDatabase:^(FMDatabase *db) {
[db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student_2 (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
[db executeUpdate:@"INSERT INTO t_student_2 (name, age) VALUES ('yixiangZZ', 20);"];
[db executeUpdate:@"INSERT INTO t_student_2 (name, age) VALUES ('yixiangXX', 25);"];
FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student_2"];
while ([rs next]) {
NSLog(@"%d %@ %d", [rs intForColumn:@"id"], [rs stringForColumn:@"name"], [rs intForColumn:@"age"]);
}
}];
// 事務版本:出問題時把 rollback 設為 YES 即可整體撤銷
[queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
[db executeUpdate:@"UPDATE t_student_2 SET age = 40 WHERE name = 'yixiangZZ'"];
[db executeUpdate:@"UPDATE t_student_2 SET age = 45 WHERE name = 'yixiangXX'"];
if (hasProblem) { *rollback = YES; return; }
}];
}
+ (instancetype)databaseQueueWithPath:(NSString *)aPath {
FMDatabaseQueue *q = [[self alloc] initWithPath:aPath];
FMDBAutorelease(q);
return q;
}
- (instancetype)initWithPath:(NSString *)aPath flags:(int)openFlags vfs:(NSString *)vfsName {
self = [super init];
if (self) {
_db = [[[self class] databaseClass] databaseWithPath:aPath];
FMDBRetain(_db);
#if SQLITE_VERSION_NUMBER >= 3005000
BOOL success = [_db openWithFlags:openFlags vfs:vfsName];
#else
BOOL success = [_db open];
#endif
if (!success) {
NSLog(@"Could not create database queue for path %@", aPath);
FMDBRelease(self);
return 0x00;
}
_path = FMDBReturnRetained(aPath);
// 重點:建立一個 GCD 序列佇列
_queue = dispatch_queue_create([[NSString stringWithFormat:@"fmdb.%@", self] UTF8String], NULL);
// 把這個序列佇列和 self 綁定,日後可用同一組 key 取回綁定的物件
dispatch_queue_set_specific(_queue, kDispatchQueueSpecificKey, (__bridge void *)self, NULL);
_openFlags = openFlags;
}
return self;
}
這段程式碼最值得看的是開頭那個防死鎖的判斷。
- (void)inDatabase:(void (^)(FMDatabase *db))block {
// 取出「當前佇列」綁定的物件。若等於 self,代表我們已經在這個佇列裡了
FMDatabaseQueue *currentSyncQueue = (__bridge id)dispatch_get_specific(kDispatchQueueSpecificKey);
assert(currentSyncQueue != self && "inDatabase: was called reentrantly on the same queue, which would lead to a deadlock");
FMDBRetain(self);
dispatch_sync(_queue, ^{
FMDatabase *db = [self database];
block(db);
if ([db hasOpenResultSets]) {
NSLog(@"Warning: there is at least one open result set around after performing [FMDatabaseQueue inDatabase:]");
}
});
FMDBRelease(self);
}
dispatch_sync 把 block 送進序列佇列,同一時間只會有一個 block 在跑,這就是執行緒安全的來源。但如果 block 內部又呼叫一次 inDatabase:,就會在序列佇列上同步等待自己,直接死鎖。蘋果早期提供 dispatch_get_current_queue 用來判斷,但那個 API 因為無法正確表達「某段同步區間」而被废弃;改用 dispatch_queue_set_specific + dispatch_get_specific 才是正解——前者替特定佇列貼上標籤,後者在任何程式碼位置都能讀出當前佇列的標籤,語意精準。
順帶一提,為什麼可以開多個 FMDatabaseQueue?因為每個 queue 各自綁一個 FMDatabase 實例,彼此獨立,可以並發操作不同的連線。
把多個任務用 dispatch_async 丟到全域佇列,再各自呼叫同一個 queue 的 inDatabase::
FMDatabaseQueue *queue1 = [FMDatabaseQueue databaseQueueWithPath:fileName];
[queue1 inDatabase:^(FMDatabase *db) {
for (int i = 0; i < 10; i++) NSLog(@"queue1---%zi--%@", i, [NSThread currentThread]);
}];
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
[queue1 inDatabase:^(FMDatabase *db) {
for (int i = 11; i < 20; i++) NSLog(@"queue1---%zi--%@", i, [NSThread currentThread]);
}];
});
// 第三個任務同理,i 從 20 到 30
執行結果顯示:即使從多條執行緒呼叫,日誌依然是 0→9、11→19、20→29 嚴格遞增,完全序列化。

原因在設計註解裡寫得很清楚:FMDatabaseQueue 本身並不是佇列,它內部建立一個 serial 的 dispatch_queue_t 來消化 inDatabase / inTransaction 傳入的 block,所以呼叫端看起來是同步的。這樣做是為了避免並發存取資料庫——資料庫請求可能在任何時刻、來自任何執行緒(例如各種網路回呼)。內建序列佇列後,所有資料庫存取都被序列化,而且比 @synchronized 或 NSLock 更有效率。
但不同 queue 之間是可以並發的:
FMDatabaseQueue *queue1 = [FMDatabaseQueue databaseQueueWithPath:fileName]; FMDatabaseQueue *queue2 = [FMDatabaseQueue databaseQueueWithPath:fileName]; // 兩個 queue 各自派發任務到全域佇列

結果是每個 queue 内部保持序列,兩個 queue 之間交錯並行。結論很明確:

也就是說,若你讓多個 queue 去操作同一個資料庫檔,就不再保證執行緒安全了——SQLite 層級還是有自己的鎖機制可以擋,但效能與錯誤處理都會變差。實務上請遵守「一個資料庫連線配一個 queue」的原則。
事務是資料庫安全的另一道防線:一段 SQL 要嘛全部成功,要嘛全部不生效。
- (void)inTransaction:(void (^)(FMDatabase *db, BOOL *rollback))block {
[self beginTransaction:NO withBlock:block];
}
- (void)beginTransaction:(BOOL)useDeferred withBlock:(void (^)(FMDatabase *db, BOOL *rollback))block {
FMDBRetain(self);
dispatch_sync(_queue, ^{ // 一樣走序列佇列,保證安全
BOOL shouldRollback = NO;
if (useDeferred) [[self database] beginDeferredTransaction]; // 延遲事務
else [[self database] beginTransaction]; // 預設排他事務
block([self database], &shouldRollback);
if (shouldRollback) [[self database] rollback];
else [[self database] commit];
});
FMDBRelease(self);
}
關於三種事務模式的差異(SQLite 3.0.8 以上):延遲(DEFERRED)在資料庫第一次被存取前不取鎖,BEGIN 本身什麼都不做;首次讀取建立 SHARED 鎖,首次寫入建立 RESERVED 鎖。因為取鎖被延後,其他執行緒/行程有機會在 BEGIN 之後搶先寫入,進而導致最終寫入時失敗。即時(IMMEDIATE)在執行 BEGIN 時立刻取 RESERVED 鎖,此後其他執行緒不能寫入,但仍可讀取。排他(EXCLUSIVE)直接取 EXCLUSIVE 鎖,事務結束前任何其他執行緒或行程都不能讀也不能寫。鎖得越早,並發度越低但衝突越少,這是一個典型的取捨。
存檔點(savepoint)讓你能在較大的事務中間標記若干可獨立回退的位置,不必整批作廢。
- (NSError *)inSavePoint:(void (^)(FMDatabase *db, BOOL *rollback))block {
#if SQLITE_VERSION_NUMBER >= 3007000
static unsigned long savePointIdx = 0;
__block NSError *err = 0x00;
FMDBRetain(self);
dispatch_sync(_queue, ^{
NSString *name = [NSString stringWithFormat:@"savePoint%ld", savePointIdx++];
BOOL shouldRollback = NO;
if ([[self database] startSavePointWithName:name error:&err]) {
block([self database], &shouldRollback);
if (shouldRollback) [[self database] rollbackToSavePointWithName:name error:&err];
[[self database] releaseSavePointWithName:name error:&err]; // 無論如何都要釋放
}
});
FMDBRelease(self);
return err;
#else
// SQLite 版本過低時回報錯誤
#endif
}
注意 releaseSavePointWithName: 一定要呼叫,否則存檔點會一直留在連線上,造成資源累積。
FMDatabasePool 用任務池的方式提供多執行緒支援,內部維護多個 FMDatabase 實例輪流使用。聽起來很美好,但官方明確表示不推薦——那句全大寫的警告值得抄下來:ONLY_USE_THE_POOL_IF_YOU_ARE_DOING_READS OTHERWISE YOULL_DEADLOCK USE_FMDATABASEQUEUE INSTEAD。原因是池中的連線若被巢狀呼叫反覆借出遲遲不歸還,很快就會耗盡而互等。實務上幾乎用不到,這裡就不展開了;記住結論就好:優先選 FMDatabaseQueue。