iOS Objective-C中无法向SQLite添加数据及建表失败求助

你已经能成功读取JSON转成NSDictionary，卡在表创建这一步对吧？咱们一步步来排查和解决：

一、先揪出创建表失败的核心原因 #

创建表失败大概率逃不开这几个点，先逐个排查：

• 数据库路径是否正确、有没有成功打开数据库
• 创建表的SQL语句有没有语法错误（比如字段名撞了SQL关键字、格式写错）
• 有没有打印SQLite的错误信息——这是定位问题的关键！

1. 先确保数据库能正常打开 #

先检查你的数据库打开代码，一定要确认sqlite3_open返回的是SQLITE_OK，示例代码给你参考：

NSString *docsDir;
NSArray *dirPaths;

// 获取App的Documents目录路径
dirPaths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
docsDir = dirPaths.firstObject;

// 拼接数据库文件的完整路径
_databasePath = [docsDir stringByAppendingPathComponent:@"user_data.db"];

sqlite3_stmt *statement;
const char *dbPath = [_databasePath UTF8String];

// 尝试打开数据库
if (sqlite3_open(dbPath, &_db) != SQLITE_OK) {
    NSLog(@"数据库打开失败！");
    // 这里一定要处理打开失败的情况，别硬往下走
    return;
}

2. 检查创建表的SQL语句+打印错误信息 #

比如你的NSDictionary里有name、age、phone这些字段，创建表的SQL要写对，而且一定要打印sqlite3_errmsg(_db)，它会告诉你具体错在哪：

// 注意：字段名别用SQL关键字，比如order、user这些，要是必须用就加反引号`order`
const char *createTableSQL = "CREATE TABLE IF NOT EXISTS user_info (id INTEGER PRIMARY KEY AUTOINCREMENT, name TEXT, age INTEGER, phone TEXT)";

if (sqlite3_prepare_v2(_db, createTableSQL, -1, &statement, NULL) != SQLITE_OK) {
    // 重点！打印错误信息，比如语法错了、表已存在（不过加了IF NOT EXISTS就不会）
    NSLog(@"创建表失败！错误信息：%s", sqlite3_errmsg(_db));
} else {
    if (sqlite3_step(statement) != SQLITE_DONE) {
        NSLog(@"执行创建表语句失败！错误信息：%s", sqlite3_errmsg(_db));
    }
    sqlite3_finalize(statement);
}

二、从NSDictionary插入数据到SQLite的完整步骤 #

等表创建成功后，就可以遍历字典的键值对插入数据了，示例代码：

// 假设你的JSON转成的字典是这样的
NSDictionary *userDict = @{@"name": @"李四", @"age": @28, @"phone": @"138xxxx1234"};

// 用?占位符绑定数据，避免SQL注入和语法错误
const char *insertSQL = "INSERT INTO user_info (name, age, phone) VALUES (?, ?, ?)";

if (sqlite3_prepare_v2(_db, insertSQL, -1, &statement, NULL) == SQLITE_OK) {
    // 占位符索引从1开始，注意匹配字段类型
    sqlite3_bind_text(statement, 1, [userDict[@"name"] UTF8String], -1, SQLITE_TRANSIENT);
    sqlite3_bind_int(statement, 2, [userDict[@"age"] intValue]);
    sqlite3_bind_text(statement, 3, [userDict[@"phone"] UTF8String], -1, SQLITE_TRANSIENT);
    
    if (sqlite3_step(statement) != SQLITE_DONE) {
        NSLog(@"插入数据失败！错误信息：%s", sqlite3_errmsg(_db));
    } else {
        NSLog(@"数据插入成功啦！");
    }
} else {
    NSLog(@"准备插入语句失败！错误信息：%s", sqlite3_errmsg(_db));
}

// 别忘了释放statement
sqlite3_finalize(statement);

三、额外要注意的小细节 #

• 用完数据库后记得调用sqlite3_close(_db)关闭连接，避免资源泄漏
• 如果字典里有特殊类型（比如日期、布尔值），要转成SQLite支持的类型（TEXT、INTEGER等），比如日期转成字符串存
• 坚决别直接拼接字符串写SQL，用?占位符绑定数据才安全

你先按照上面的方法，先打印出创建表时的错误信息，根据提示调整，应该很快就能解决问题啦！

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