终极指南：FMDB异常捕获全解析——Objective-C try/catch与Swift do/try/catch实战

终极指南：FMDB异常捕获全解析——Objective-C try/catch与Swift do/try/catch实战

【免费下载链接】fmdb ccgus/fmdb: 是一个 iOS 的SQLite 数据库框架。适合用于iOS 开发中的数据存储和管理。 项目地址: https://gitcode.com/gh_mirrors/fm/fmdb

引言：为什么FMDB异常处理至关重要？

在iOS开发中，数据存储是应用稳定性的关键环节。FMDB（GitHub 加速计划 / fm / fmdb）作为SQLite数据库的Objective-C封装框架，广泛应用于iOS应用的数据持久化。然而，SQLite操作可能因各种原因失败，如磁盘空间不足、权限问题、SQL语法错误等。未处理的异常可能导致应用崩溃，影响用户体验。本文将详细介绍如何在Objective-C和Swift中使用try/catch机制捕获FMDB异常，确保应用的健壮性。

FMDB异常处理基础

FMDB异常来源

FMDB操作可能抛出的异常主要包括：

• SQL语法错误
• 数据库连接失败
• 事务处理错误
• 数据读写异常

FMDB错误处理机制

FMDB提供了多种错误处理方式：

• 通过lastError、lastErrorCode和lastErrorMessage方法获取错误信息
• 使用hadError方法检查是否发生错误
• 在Swift中，部分方法会抛出NSError

// 检查错误示例 [src/fmdb/FMDatabase.h](https://link.gitcode.com/i/58169616e245711a30e459b8801109b1/blob/1227a3fa2b9916bfd75fe380eb45cd210e69e251/src/fmdb/FMDatabase.h?utm_source=gitcode_repo_files#L580-L585)
if ([db hadError]) {
    NSLog(@"Error: %@", [db lastErrorMessage]);
}

Objective-C中的异常捕获

try/catch基本用法

Objective-C使用@try、@catch和@finally块处理异常：

@try {
    // 可能抛出异常的FMDB操作
    [db executeUpdate:@"INSERT INTO users (name, age) VALUES (?, ?)", name, age];
}
@catch (NSException *exception) {
    // 异常处理
    NSLog(@"FMDB Error: %@", exception.reason);
}
@finally {
    // 无论是否发生异常都会执行的代码
    [db close];
}

FMDB特定异常处理

FMDB的FMDatabase类提供了crashOnErrors属性，当设置为YES时，错误会导致应用崩溃。默认情况下，错误不会抛出异常，需要手动检查：

db.crashOnErrors = NO; // 默认值
if (![db executeUpdate:@"INSERT INTO users (name, age) VALUES (?, ?)", name, age]) {
    NSLog(@"Error: %@", [db lastErrorMessage]);
}

事务中的异常处理

在事务中使用异常捕获可以确保数据一致性：

[db beginTransaction];
@try {
    [db executeUpdate:@"INSERT INTO users (name) VALUES (?)", @"Alice"];
    [db executeUpdate:@"INSERT INTO users (name) VALUES (?)", @"Bob"];
    [db commit];
}
@catch (NSException *exception) {
    [db rollback];
    NSLog(@"Transaction failed: %@", exception.reason);
}

Swift中的异常捕获

do/try/catch基本用法

Swift使用do、try和catch处理异常：

do {
    try db.executeUpdate("INSERT INTO users (name, age) VALUES (?, ?)", values: [name, age])
} catch {
    print("FMDB Error: \(error.localizedDescription)")
}

FMDB Swift扩展

FMDB为Swift提供了抛出错误的方法，如executeUpdate(sql:values:error:)：

// [src/fmdb/FMDatabase.h](https://link.gitcode.com/i/58169616e245711a30e459b8801109b1/blob/1227a3fa2b9916bfd75fe380eb45cd210e69e251/src/fmdb/FMDatabase.h?utm_source=gitcode_repo_files#L470)
func executeUpdate(sql: String, values: [Any]?) throws -> Bool

使用示例：

do {
    try db.executeUpdate("INSERT INTO users (name, age) VALUES (?, ?)", values: [name, age])
} catch let error as NSError {
    print("FMDB Error: \(error.domain), Code: \(error.code)")
}

FMDB高级异常处理技巧

使用FMDatabaseQueue处理并发

FMDatabaseQueue确保数据库操作在串行队列中执行，避免多线程冲突导致的异常：

// [src/fmdb/FMDatabaseQueue.h](https://link.gitcode.com/i/58169616e245711a30e459b8801109b1/blob/1227a3fa2b9916bfd75fe380eb45cd210e69e251/src/fmdb/FMDatabaseQueue.h?utm_source=gitcode_repo_files#L209)
[queue inDatabase:^(FMDatabase *db) {
    @try {
        [db executeUpdate:@"INSERT INTO users (name) VALUES (?)", @"Charlie"];
    }
    @catch (NSException *exception) {
        NSLog(@"Error in queue: %@", exception.reason);
    }
}];

事务中的保存点

使用保存点（Savepoint）可以实现部分事务回滚：

// [src/fmdb/FMDatabaseQueue.h](https://link.gitcode.com/i/58169616e245711a30e459b8801109b1/blob/1227a3fa2b9916bfd75fe380eb45cd210e69e251/src/fmdb/FMDatabaseQueue.h?utm_source=gitcode_repo_files#L259)
NSError *error = [queue inSavePoint:^(FMDatabase *db, BOOL *rollback) {
    if (![db executeUpdate:@"INSERT INTO users (name) VALUES (?)", @"Dave"]) {
        *rollback = YES;
    }
}];
if (error) {
    NSLog(@"Savepoint error: %@", error.localizedDescription);
}

异常处理最佳实践

1. 始终检查错误返回值

即使使用异常捕获，也应检查FMDB方法的返回值：

BOOL success = [db executeUpdate:@"INSERT INTO users (name) VALUES (?)", name];
if (!success) {
    NSLog(@"Insert failed: %@", [db lastErrorMessage]);
}

2. 使用事务确保数据一致性

对多个相关操作使用事务，确保要么全部成功，要么全部失败：

[db beginTransaction];
BOOL success = YES;
if (![db executeUpdate:@"INSERT INTO table1 ..."]) success = NO;
if (![db executeUpdate:@"UPDATE table2 ..."]) success = NO;

if (success) {
    [db commit];
} else {
    [db rollback];
}

3. 避免在主线程执行耗时操作

长时间的数据库操作应放在后台线程执行，避免UI卡顿：

dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
    FMDatabase *db = [FMDatabase databaseWithPath:databasePath];
    if ([db open]) {
        // 执行数据库操作
        [db close];
    }
});

4. 详细日志记录

记录详细的错误日志，便于调试：

@try {
    [db executeUpdate:sql];
}
@catch (NSException *exception) {
    NSLog(@"FMDB Exception: %@\nSQL: %@\nStack Trace: %@", 
          exception.reason, sql, exception.callStackSymbols);
}

常见FMDB异常及解决方案

1. SQLITE_BUSY (5)

原因：数据库被锁定，其他连接正在执行写操作。

解决方案：设置重试机制或使用FMDatabaseQueue：

// 设置重试时间 [src/fmdb/FMDatabase.h](https://link.gitcode.com/i/58169616e245711a30e459b8801109b1/blob/1227a3fa2b9916bfd75fe380eb45cd210e69e251/src/fmdb/FMDatabase.h?utm_source=gitcode_repo_files#L339-L340)
db.maxBusyRetryTimeInterval = 5; // 5秒重试

2. SQLITE_CONSTRAINT (19)

原因：违反约束（如唯一键冲突）。

解决方案：捕获特定错误码并处理：

if ([db lastErrorCode] == SQLITE_CONSTRAINT) {
    NSLog(@"Constraint violation: %@", [db lastErrorMessage]);
    // 处理重复数据
}

3. SQLITE_MISUSE (21)

原因：数据库使用不当（如未打开连接）。

解决方案：确保数据库正确打开：

if (![db open]) {
    NSLog(@"Could not open database: %@", [db lastErrorMessage]);
    return;
}

总结

FMDB异常处理是确保iOS应用数据操作稳定性的关键。通过本文介绍的Objective-C try/catch和Swift do/try/catch机制，结合FMDB提供的错误处理方法，可以有效捕获和处理数据库操作中可能出现的异常。建议在实际开发中：

1. 始终检查FMDB方法的返回值
2. 使用FMDatabaseQueue处理并发操作
3. 对关键数据操作使用事务
4. 记录详细的错误日志
5. 根据具体错误类型采取不同的恢复策略

通过合理的异常处理，可以显著提高应用的健壮性和用户体验。

参考资料

• FMDB官方文档：README.markdown
• FMDB头文件：src/fmdb/FMDatabase.h
• FMDB队列操作：src/fmdb/FMDatabaseQueue.h
• SQLite错误码：SQLite Error Codes

【免费下载链接】fmdb ccgus/fmdb: 是一个 iOS 的SQLite 数据库框架。适合用于iOS 开发中的数据存储和管理。 项目地址: https://gitcode.com/gh_mirrors/fm/fmdb