Swift 4 向SQLite插入用户失败：报SQL逻辑错误或数据库缺失

嘿，我一眼就发现问题所在了——你贴出来的代码根本不是插入用户的逻辑，而是用来查询并遍历结果集的循环！这就是为什么你会碰到SQL逻辑错误的原因。

核心问题分析 #

sqlite3_step(stmt) == SQLITE_ROW这个判断是专门用来处理SELECT查询返回的每一行数据的，而插入操作（INSERT）执行成功时，sqlite3_step会返回SQLITE_DONE。用查询结果的循环逻辑去跑插入语句，自然会触发SQL逻辑错误。

正确的插入用户流程 #

下面是针对你的场景（从输入框获取姓名、邮箱、年龄、性别插入SQLite）的正确实现步骤：

1. 准备参数化的INSERT语句
   使用占位符?可以避免SQL注入，同时也能避免字段格式（比如字符串含特殊字符）导致的错误。
2. 绑定输入框的参数到占位符
   注意占位符的索引是从1开始的，要和字段顺序对应。
3. 执行插入并检查结果
   判断sqlite3_step的返回值是否为SQLITE_DONE来确认插入成功。
4. 清理资源
   执行完后要调用sqlite3_finalize销毁语句对象。

完整示例代码 #

// 假设你已经成功打开了数据库连接（变量名为db）
let insertQuery = "INSERT INTO users (name, email, age, gender) VALUES (?, ?, ?, ?)"
var insertStmt: OpaquePointer?

// 1. 准备插入语句
if sqlite3_prepare_v2(db, insertQuery, -1, &insertStmt, nil) != SQLITE_OK {
    let errorMessage = String(cString: sqlite3_errmsg(db))
    print("Failed to prepare insert statement: \(errorMessage)")
    return
}

// 2. 从输入框获取数据（这里建议做非空校验，避免强制解包崩溃）
guard let name = nameTextField.text, !name.isEmpty,
      let email = emailTextField.text, !email.isEmpty,
      let ageText = ageTextField.text, let age = Int(ageText),
      let gender = genderTextField.text, !gender.isEmpty else {
    print("Please fill in all fields correctly")
    sqlite3_finalize(insertStmt)
    return
}

// 3. 绑定参数到占位符（索引从1开始）
sqlite3_bind_text(insertStmt, 1, name, -1, SQLITE_TRANSIENT)
sqlite3_bind_text(insertStmt, 2, email, -1, SQLITE_TRANSIENT)
sqlite3_bind_int(insertStmt, 3, Int32(age))
sqlite3_bind_text(insertStmt, 4, gender, -1, SQLITE_TRANSIENT)

// 4. 执行插入并检查结果
if sqlite3_step(insertStmt) == SQLITE_DONE {
    print("User saved successfully!")
} else {
    let errorMessage = String(cString: sqlite3_errmsg(db))
    print("Failure inserting user: \(errorMessage)")
}

// 5. 清理语句资源
sqlite3_finalize(insertStmt)

额外排查点（针对"missing database"错误） #

如果错误还存在，你需要检查：

• 数据库文件的路径是否正确，应用是否有读写该路径的权限。
• 确保users表已经在数据库中创建，表结构和你插入的字段完全匹配（比如age字段是INTEGER类型，其他是TEXT类型）。
• 数据库连接是否成功建立（可以在打开数据库后检查返回值是否为SQLITE_OK）。

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