C语言中适配含空字节缓冲区的sprintf()替代方案（SQLite3场景）

我需要把包含空字节（0x00）的二进制缓冲区写入SQLite3数据库，但用sprintf/snprintf构造SQL语句时，遇到空字节就会截断字符串，导致数据写入不完整。

我的二进制缓冲区示例：

static unsigned char bytes_buffer[] = {
        0x30, 0x82, 0x01, 0x4b, 0x30, 0x82, 0x01, 0x03, 0x06, 0x07, 0x2a, 0x86,
        0x48, 0xce, 0x3d, 0x02, 0x01, 0x30, 0x81, 0xf7, 0x02, 0x01, 0x01, 0x30,
        0x2c, 0x06, 0x07, 0x2a, 0x86, 0x48, 0xce, 0x3d, 0x01, 0x01, 0x02, 0x21,
        0x00, 0xff, 0xff, 0xff, 0xff, 0x00, 0x00, 0x00, 0x01, 0x00};

我原来的SQL构造代码：

unsigned char *sql=(unsigned char *)malloc((size_t)(sizeof(unsigned char)*SQL_SIZE));
sprintf(sql,"UPDATE table SET buffer='%s', WHERE id=%d",bytes_buffer,id);
printf("SQL: %s\n",sql);
if (sqlite3_exec(db, sql, NULL, NULL, NULL) != SQLITE_OK)
{
    return SQLITE_ERROR;
}
else
    return SQLITE_OK;

问题核心：%s格式符会把输入当作以空字符结尾的C字符串，遇到0x00就停止处理，导致缓冲区里的后续数据无法写入SQL语句。

解决方案 #

方案1：使用SQLite参数化查询（推荐） #

这是最安全、最可靠的方式，既避免SQL注入，又能原生支持二进制数据（包括空字节）。不需要手动构造带二进制的SQL字符串，直接用sqlite3_bind_blob绑定二进制数据：

int update_buffer(sqlite3 *db, int id, const unsigned char *buffer, size_t buffer_len) {
    sqlite3_stmt *stmt;
    const char *sql = "UPDATE table SET buffer = ? WHERE id = ?";
    
    // 准备预编译语句
    if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) != SQLITE_OK) {
        return SQLITE_ERROR;
    }
    
    // 绑定二进制数据：第一个参数是占位符索引（从1开始），第二个是缓冲区，第三个是长度，第四个是内存管理策略
    sqlite3_bind_blob(stmt, 1, buffer, buffer_len, SQLITE_STATIC); // 如果buffer是静态/全局的用SQLITE_STATIC，动态分配的用SQLITE_TRANSIENT
    // 绑定ID
    sqlite3_bind_int(stmt, 2, id);
    
    // 执行语句
    int result = sqlite3_step(stmt);
    if (result != SQLITE_DONE) {
        sqlite3_finalize(stmt);
        return SQLITE_ERROR;
    }
    
    // 释放语句资源
    sqlite3_finalize(stmt);
    return SQLITE_OK;
}

调用时直接传入bytes_buffer和它的长度（比如sizeof(bytes_buffer)）即可。

方案2：手动将二进制转成SQL兼容的十六进制格式（不推荐） #

如果一定要手动构造SQL字符串，需要把每个字节转换成两位十六进制字符，然后用SQL的X'hex-string'语法表示二进制数据。比如写一个辅助函数把二进制转成十六进制字符串：

// 把二进制数据转成十六进制字符串，返回的字符串需要手动free
char* bin_to_hex(const unsigned char *bin, size_t len) {
    char *hex = malloc(len * 2 + 1);
    if (!hex) return NULL;
    
    for (size_t i = 0; i < len; i++) {
        sprintf(hex + i*2, "%02x", bin[i]);
    }
    hex[len*2] = '\0';
    return hex;
}

然后构造SQL语句：

size_t buf_len = sizeof(bytes_buffer);
char *hex_str = bin_to_hex(bytes_buffer, buf_len);
if (!hex_str) {
    // 内存分配失败处理
    return SQLITE_ERROR;
}

// 计算需要的SQL长度，预留足够空间
size_t sql_len = snprintf(NULL, 0, "UPDATE table SET buffer=X'%s' WHERE id=%d", hex_str, id) + 1;
unsigned char *sql = malloc(sql_len);
if (!sql) {
    free(hex_str);
    return SQLITE_ERROR;
}

sprintf((char*)sql, "UPDATE table SET buffer=X'%s' WHERE id=%d", hex_str, id);

// 执行SQL...
if (sqlite3_exec(db, (char*)sql, NULL, NULL, NULL) != SQLITE_OK) {
    free(sql);
    free(hex_str);
    return SQLITE_ERROR;
}

free(sql);
free(hex_str);
return SQLITE_OK;

注意：这种方式有SQL注入风险，如果id是用户输入的话需要额外处理，而且性能不如参数化查询，只适合简单场景。

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