Swift使用sqlite3插入数据时报API call with invalid database connection pointer错误如何解决

1. 直接报错诱因：sqlite3_errmsg传参错误 #

你打印错误信息时调用的sqlite3_errmsg(insertStatement)不符合接口规范：sqlite3_errmsg要求传入的参数是sqlite3数据库连接指针（即你的userDB对象），而非prepared statement语句指针。你传入语句指针的操作直接触发了“无效数据库连接指针”的报错。
正确写法如下：

// 把入参换成数据库连接指针，同时转换为Swift可读的字符串类型
print(String(cString: sqlite3_errmsg(userDB)))

2. 隐性风险：未对数据库连接做非空校验 #

你的createDB()方法返回的是可选类型OpaquePointer?，你在insertRating中拿到userDB后没有做解包判断，如果createDB打开数据库失败返回nil，后续所有sqlite3操作传入空指针都会触发非法指针报错。
建议补充解包逻辑：

guard let userDB = UserDatabase().createDB() else {
    print("数据库打开失败，终止插入操作")
    return
}

3. 不规范写法：直接拼接SQL字符串 #

你当前直接用字符串拼接生成插入语句，存在两个明显问题：

• 如果入参（比如图片URL、用户名）包含单引号、特殊字符，会直接导致SQL语法错误，插入失败
• 存在SQL注入风险
  推荐使用sqlite官方提供的参数绑定写法，示例：

let insertStatementString = "insert into Rating (Picture,Rating,UserID_fk) values(?, ?, (select UserID from Users where Username = ?))"
if sqlite3_prepare_v2(userDB, insertStatementString, -1, &insertStatement, nil) == SQLITE_OK {
    // 按顺序绑定参数
    sqlite3_bind_text(insertStatement, 1, (picture as NSString).utf8String, -1, nil)
    sqlite3_bind_double(insertStatement, 2, rating)
    sqlite3_bind_text(insertStatement, 3, (usrname as NSString).utf8String, -1, nil)
    // 后续执行sqlite3_step操作
}

4. 其他需要遵守的sqlite3操作规范 #

• sqlite3默认不是线程安全的，如果你存在多线程操作同一个数据库的需求，需要在打开数据库时添加SQLITE_OPEN_FULLMUTEX flag，或者保证所有数据库操作都在同一个串行队列中执行
• 你当前每次调用插入接口都开关一次数据库，频繁开关会产生不必要的性能损耗，如果插入操作比较频繁，建议维持长连接，在App退出等合适的全局时机再关闭数据库
• 执行sqlite3_finalize、sqlite3_close前最好先判断指针非空，避免传入空指针触发异常

内容的提问来源于stack exchange，提问作者Justin Philip Fulkerson