向SQLite3数据库写入浮点型变量失败的技术咨询

核心原因 #

你只定义了带命名占位符的SQL语句，但没有完成参数绑定的关键步骤——数据库不知道$co2、$temp、$hum对应哪个浮点变量，相当于没给这些占位符赋值，所以插入后字段为空。直接写数值是把值硬编码进SQL，数据库能直接解析，所以正常。

另外可能的次要问题：

• 误用了绑定函数（比如用sqlite3_bind_text绑定浮点数，导致类型不匹配）
• 命名占位符的拼写和绑定时的名称不一致
• 绑定参数时传递了无效的变量（比如未初始化的指针）

解决方法 #

必须按照SQLite参数化查询的完整流程执行，以下是正确的代码示例：

#include <sqlite3.h>
#include <stdio.h>

int main() {
    sqlite3 *db;
    char *err_msg = 0;
    int rc = sqlite3_open("your_database.db", &db);

    if (rc != SQLITE_OK) {
        fprintf(stderr, "无法打开数据库: %s\n", sqlite3_errmsg(db));
        sqlite3_close(db);
        return 1;
    }

    // 带命名占位符的SQL
    char *sql = "INSERT INTO Readings (CO2, TEMPERATURE, HUMIDITY) VALUES ($co2, $temp, $hum);";
    sqlite3_stmt *stmt;

    // 1. 准备语句
    rc = sqlite3_prepare_v2(db, sql, -1, &stmt, 0);
    if (rc != SQLITE_OK) {
        fprintf(stderr, "准备语句失败: %s\n", sqlite3_errmsg(db));
        sqlite3_close(db);
        return 1;
    }

    // 模拟要插入的浮点变量
    double co2_val = 833.42;
    double temp_val = 23.11;
    double hum_val = 40.25;

    // 2. 绑定参数：通过占位符名称获取索引，再绑定double类型值
    int co2_idx = sqlite3_bind_parameter_index(stmt, "$co2");
    sqlite3_bind_double(stmt, co2_idx, co2_val);

    int temp_idx = sqlite3_bind_parameter_index(stmt, "$temp");
    sqlite3_bind_double(stmt, temp_idx, temp_val);

    int hum_idx = sqlite3_bind_parameter_index(stmt, "$hum");
    sqlite3_bind_double(stmt, hum_idx, hum_val);

    // 3. 执行插入
    rc = sqlite3_step(stmt);
    if (rc != SQLITE_DONE) {
        fprintf(stderr, "执行插入失败: %s\n", sqlite3_errmsg(db));
        sqlite3_finalize(stmt);
        sqlite3_close(db);
        return 1;
    }

    // 4. 清理资源
    sqlite3_finalize(stmt);
    sqlite3_close(db);

    return 0;
}

关键注意点 #

• 必须调用sqlite3_prepare_v2准备语句，这是参数化查询的前提
• 用sqlite3_bind_double绑定浮点型变量，对应SQLite的REAL类型字段
• 如果觉得命名占位符麻烦，可以改用位置占位符?，绑定时直接用索引（从1开始）：

  char *sql = "INSERT INTO Readings (CO2, TEMPERATURE, HUMIDITY) VALUES (?, ?, ?);";
  // 绑定第一个参数（CO2）
  sqlite3_bind_double(stmt, 1, co2_val);
  // 绑定第二个参数（温度）
  sqlite3_bind_double(stmt, 2, temp_val);
  // 绑定第三个参数（湿度）
  sqlite3_bind_double(stmt, 3, hum_val);
  

• 执行后要检查返回值，确保sqlite3_step返回SQLITE_DONE表示插入成功
• 最后必须调用sqlite3_finalize释放语句资源，避免内存泄漏

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