MySQL C API 动态结果列怎么先读取元数据再绑定

MySQL C API 处理列数和列类型不固定的 SELECT 时，正确顺序是：先执行语句，再用 mysql_stmt_result_metadata() 取得 MYSQL_RES，通过 mysql_num_fields() 和 mysql_fetch_fields() 读取每列的元数据，最后按列创建 MYSQL_BIND 并绑定到结果缓冲区。mysql_stmt_fetch() 只负责把行写入已经绑定的缓冲区，不能替代前面的列描述阶段。

官方资料：https://dev.mysql.com/doc/c-api/8.4/en/mysql-stmt-result-metadata.html

动态结果列的关键不是“先分配一个很大的数组”，而是让列数、字段类型、接收缓冲区和长度指针保持同一个下标。绑定完成后，再用 is_null、length 和 fetch 返回码判断这一行的实际状态。

先用元数据建立结果列槽位

mysql_stmt_result_metadata() 返回的是结果集的元数据，不是行数据。返回非空后，可以用 mysql_num_fields() 得到列数，用 mysql_fetch_fields() 取得连续的 MYSQL_FIELD 数组。每个数组元素描述一列，常用字段包括列名、type 和长度提示。

执行顺序上，结果集已经实际产生后读取元数据更稳妥：此时看到的是结果集中的类型。若语句是 CALL 并产生多个结果集，应在每个结果集切换后分别读取元数据。

按 MYSQL_FIELD.type 配置 MYSQL_BIND

绑定数组必须有一个元素对应一个结果列。数组和它指向的缓冲区要一直存活到 fetch 循环结束；只在循环体内声明临时变量，会让绑定指针悬空。下面的示例把整数归一到 long long，浮点数归一到 double，日期时间使用 MYSQL_TIME，其余类型先按字符串接收。

#include 
#include 
#include 
#include 
#include 

/* 说明：stmt 已经 prepare 并 execute，下面只处理动态结果列。 */
MYSQL_RES *meta = mysql_stmt_result_metadata(stmt);
if (meta == NULL) {
    /* 没有结果集时先看错误；非查询语句可能本来就没有元数据。 */
    if (mysql_stmt_errno(stmt) != 0) {
        fprintf(stderr, "metadata: %s\n", mysql_stmt_error(stmt));
    }
    return 1;
}

unsigned int n = mysql_num_fields(meta);
MYSQL_FIELD *fields = mysql_fetch_fields(meta);
MYSQL_BIND *bind = calloc(n, sizeof(*bind));
void **storage = calloc(n, sizeof(*storage));
unsigned long *lengths = calloc(n, sizeof(*lengths));
bool *nulls = calloc(n, sizeof(*nulls));
if (bind == NULL || storage == NULL || lengths == NULL || nulls == NULL) {
    /* 任何一块分配失败都不能继续绑定，避免部分初始化的数组被使用。 */
    return 1;
}

for (unsigned int i = 0; i 

这里的 buffer_type 表示“按什么 C 类型接收”，不必机械复制服务器字段类型；但转换必须是客户端库支持的类型。字符串和 BLOB 不应只看一块固定数组是否够大，而要结合 length 和 MYSQL_DATA_TRUNCATED 做后续处理。

fetch 时看 length、NULL 与截断返回码

绑定成功后，mysql_stmt_fetch() 每取到一行，就把结果写入 buffer，把实际长度写入 length，把 NULL 状态写入 is_null。返回值为 0 表示当前行成功，MYSQL_NO_DATA 表示没有更多行，MYSQL_DATA_TRUNCATED 表示至少有一列容量不足。

for (;;) {
    /* 返回码先于业务字段判断，避免把截断行误当成完整数据。 */
    int rc = mysql_stmt_fetch(stmt);
    if (rc == MYSQL_NO_DATA) {
        break;
    }
    if (rc == 1) {
        fprintf(stderr, "fetch: %s\n", mysql_stmt_error(stmt));
        break;
    }

    for (unsigned int i = 0; i 

如果列是很长的字符串或 BLOB，可以先把该列绑定为零长度缓冲区，让 length 得到真实长度，再按长度分配内存并调用 mysql_stmt_fetch_column()。这比盲目把所有列都分配成超大数组更可控。

释放顺序和四个容易忽略的边界

元数据使用完后调用 mysql_free_result(meta)；每个 storage[i]、bind、lengths 和 nulls 都要释放，最后再关闭 statement。释放前不要再次 fetch，也不要让下一轮查询复用旧的字段数组。

• 列数必须一致：MYSQL_BIND 少于结果列时，未绑定的列不会被正确接收。
• NULL 不等于空字符串：判断 is_null 后再读取 buffer。
• 长度不等于容量：length 是当前值长度，buffer_length 是接收空间。
• 元数据可能被抑制：若连接启用了可选结果集元数据，字段信息可能为空；代码应接受只有列数、没有字段描述的情况。

常见问题

为什么不能在 mysql_stmt_prepare 后直接把所有列绑定成字符串？

可以在明确转换规则且容量足够时这样做，但它会掩盖数值、时间、NULL 和长字段的边界。动态结果更稳妥的做法是先读字段类型，再选择接收类型和容量。

mysql_stmt_result_metadata 返回 NULL 就一定是错误吗？

不一定。没有结果集的语句本来就没有结果元数据；只有在 statement 错误码非零时，才应按错误处理。对会返回结果集的 SELECT，如果元数据为空，则应停止后续绑定并检查 statement 状态。

归纳起来，动态结果列的可靠流程就是“元数据描述列，绑定数组承接列，fetch 写入值，length/is_null 描述值”。把四者按同一列下标维护，才能在列数变化、NULL、长字段和类型转换同时出现时仍保持可控。