用 C 连 MySQL,代码不长,出错点却分散在三个互不相干的阶段:编译时要找到 mysql.h,链接时要找到 libmysqlclient,运行时动态加载器还要找到 .so。接口本身只有一条固定的调用链。
先确认库能被找到
Connector/C 解压后是 include 和 lib 两个目录:include 放声明,lib 放 .a 和 .so。先用一个最小程序验证:
#include <stdio.h>
#include <mysql.h>
int main(void)
{
printf("mysql client version: %s\n", mysql_get_client_info());
return 0;
}gcc -o version version.c -I./include -L./lib -lmysqlclient
./version编译通过不代表能跑:
./version: error while loading shared libraries: libmysqlclient.so.18: cannot open shared object file: No such file or directory-I 管编译,-L 管链接,运行时搜索路径不归它们管。三种处理方式:
# 1. 临时改运行时搜索路径
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:./lib
# 2. 把库路径写进可执行文件
gcc -o version version.c -I./include -L./lib -lmysqlclient \
-Wl,-rpath,'$ORIGIN/lib'
# 3. 装进系统目录并刷新缓存
sudo cp lib/libmysqlclient.so* /usr/local/lib/ && sudo ldconfig临时调试用第一种,交付程序用第二种。$ORIGIN 表示可执行文件所在目录,程序搬到哪都能找到同目录下的 lib,不依赖使用者记得设环境变量。ldd ./version | grep mysql 能看到它实际在找哪个 .so。
-l 的顺序也有意义:链接器从左到右扫描,-lmysqlclient 要放在源文件后面,否则扫到这个库时还没有未解析符号,库会被丢弃。机器上装了开发包的话,mysql_config --cflags --libs 直接给出参数,不用手写 -I 和 -L。
一次查询的固定顺序
接口顺序是:init → connect → query → store_result → fetch_row → free_result → close。少任何一步,后面的调用都会出问题。下面假设 test 库里有 account 表,字段沿用课件的 blance。
| 函数 | 用途 |
|---|---|
MYSQL *mysql_init(MYSQL *) | 初始化连接句柄,传 NULL 让库分配 |
MYSQL *mysql_real_connect | 八个参数,建立连接,失败返回 NULL |
int mysql_query(MYSQL *, const char *) | 下发一条 SQL,0 表示成功 |
MYSQL_RES *mysql_store_result(MYSQL *) | 把整个结果集取回本地 |
my_ulonglong mysql_num_rows(MYSQL_RES *) | 结果集的行数 |
unsigned int mysql_num_fields(MYSQL_RES *) | 结果集的列数 |
MYSQL_FIELD *mysql_fetch_fields(MYSQL_RES *) | 列元信息数组,取 .name 等 |
MYSQL_ROW mysql_fetch_row(MYSQL_RES *) | 取下一行,读完返回 NULL |
void mysql_free_result(MYSQL_RES *) | 释放结果集 |
void mysql_close(MYSQL *) | 关闭连接 |
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <mysql.h>
static void die(MYSQL *conn, const char *what)
{
fprintf(stderr, "%s: [%u] %s\n", what, mysql_errno(conn), mysql_error(conn));
mysql_close(conn);
exit(EXIT_FAILURE);
}
int main(void)
{
MYSQL *conn = mysql_init(NULL);
if (conn == NULL) {
fprintf(stderr, "mysql_init failed\n");
return EXIT_FAILURE;
}
if (mysql_real_connect(conn, "127.0.0.1", "app", "Str0ng#Pass",
"test", 3306, NULL, 0) == NULL) {
die(conn, "connect");
}
if (mysql_set_character_set(conn, "utf8mb4") != 0) {
die(conn, "set charset");
}
if (mysql_query(conn, "select id, name, blance from account order by id") != 0) {
die(conn, "query");
}
MYSQL_RES *res = mysql_store_result(conn);
if (res == NULL) {
if (mysql_field_count(conn) == 0) {
printf("no result set, affected rows: %llu\n",
(unsigned long long)mysql_affected_rows(conn));
mysql_close(conn);
return 0;
}
die(conn, "store_result");
}
unsigned int ncols = mysql_num_fields(res);
MYSQL_FIELD *fields = mysql_fetch_fields(res);
for (unsigned int i = 0; i < ncols; i++) {
printf("%s%s", fields[i].name, i + 1 < ncols ? "\t" : "\n");
}
MYSQL_ROW row;
while ((row = mysql_fetch_row(res)) != NULL) {
unsigned long *len = mysql_fetch_lengths(res);
for (unsigned int j = 0; j < ncols; j++) {
if (row[j] == NULL) {
printf("NULL");
} else {
printf("%.*s", (int)len[j], row[j]);
}
printf("%s", j + 1 < ncols ? "\t" : "\n");
}
}
if (mysql_errno(conn) != 0) {
fprintf(stderr, "fetch: %s\n", mysql_error(conn));
}
printf("rows: %llu\n", (unsigned long long)mysql_num_rows(res));
mysql_free_result(res);
mysql_close(conn);
return 0;
}编译链接:
gcc -o demo demo.c $(mysql_config --cflags --libs)mysql_init(NULL) 让库自己分配 MYSQL。传一个栈上的结构体地址,后续 API 会直接操作那块内存,函数返回后句柄悬空,mysql_close 释放的是一块已经不在有效范围内的内存。MYSQL 也不是一个整数连接号,它保存端口、库名、字符集、错误信息和一张函数指针表,mysql_store_result 之类的内部实现顺着这张表调用协议层。
mysql_real_connect 有八个参数:句柄、host、user、password、db、port、unix_socket、client_flag。port 写 0 用默认 3306;host 写 localhost 在 Linux 上常走 Unix socket,写 127.0.0.1 才是 TCP;db 写一个不存在的库会直接连不上。连接失败返回 NULL,原因从 mysql_errno / mysql_error 取。1045 是账号密码或 host 不允许,2003 是服务没起或被防火墙挡了,2059 通常是客户端库太老、不认识 8.0 的 caching_sha2_password。
MYSQL_RES、MYSQL_FIELD、MYSQL_ROW
三个类型各管一层:MYSQL_RES 是整个结果集,MYSQL_FIELD 是一列的元信息,MYSQL_ROW 是一行的数据。
mysql_store_result 把整个结果集拉到本地。它返回 NULL 时,要区分“本来就没有结果集”和“取结果失败”:
MYSQL_RES *res = mysql_store_result(conn);
if (res == NULL) {
if (mysql_field_count(conn) == 0) {
printf("no result set, affected rows: %llu\n",
(unsigned long long)mysql_affected_rows(conn));
} else {
fprintf(stderr, "store failed: %s\n", mysql_error(conn));
}
}有字段却拿不到结果集才是错误。DML 本来就没有结果集,mysql_field_count 返回 0,这时看 mysql_affected_rows 来判断影响了几行。
MYSQL_ROW 就是 char **,row[j] 是字符串。非预处理语句走文本协议,int、decimal、datetime 全都是字符串,要数字自己做 strtoll / strtod。NULL 单元格是空指针,直接 %s 打印是未定义行为。文本里可能有 \0,按 mysql_fetch_lengths 给的长度打印才安全。
mysql_fetch_row 返回的指针只在下次 mysql_fetch_row 或 mysql_free_result 之前有效。想留着这一行,必须自己拷走;存一个指针数组,循环结束后拿到的全是同一块被覆盖的内存。
mysql_num_rows 返回 my_ulonglong,打印用 %llu;赋给 int 在超大数据量时会溢出。
课件写“记得 free(result)”。这里必须用 mysql_free_result(result),不能调标准库的 free()。结果集内部除了行缓冲,还有字段数组、长度数组等多块子分配,只释放外层指针回收不干净,内层分配就泄漏了;分配和释放必须用同一套函数配对。课件示例里还有两处编译不过的地方:用了 cout 却没包含 <iostream>,行循环里的 nums 没有定义,它应该是 mysql_num_rows(res) 的结果。
返回值:0 表示成功,true 也表示成功
mysql_query 返回 0 成功、非 0 失败;mysql_autocommit、mysql_commit、mysql_rollback 返回 true 成功、false 失败。两套约定相反,读代码时容易看反。
mysql_autocommit(conn, 0); /* 关闭自动提交,进入事务 */
/* 若干条 DML */
if (mysql_commit(conn) == 0) { /* 返回 0 才是失败 */
fprintf(stderr, "commit: %s\n", mysql_error(conn));
}
mysql_autocommit(conn, 1); /* 恢复自动提交 */mysql_query 返回 0 只代表语句被执行了,不代表业务成功。带条件的 update 影响 0 行也算成功,要用 mysql_affected_rows 判断。事务结束不恢复自动提交,后面的语句会一直挂在一个没提交的事务里。
课件的事务函数原型写 my_bool。8.0 的头文件已经改用 bool,my_bool 不再提供;变量照旧写 my_bool 会编译失败。字符集也有版本差:课件说原始默认是 latin1,那是 5.x;8.0 服务端和连接的默认都是 utf8mb4。连接后设一次:
if (mysql_set_character_set(conn, "utf8mb4") != 0) {
fprintf(stderr, "charset: %s\n", mysql_error(conn));
}写 "utf8" 得到的是 utf8mb3,最多 3 字节;要完整 Unicode 就写 "utf8mb4"。
一个 MYSQL * 不能被多个线程同时使用。连接上的查询是有状态的:结果集没取完就发下一条,会报 Commands out of sync。多线程程序每个线程用自己的连接。
拼 SQL 的两个边界
把变量用 sprintf 拼进语句,有两个问题:缓冲区可能不够,输入里的单引号会改变语句结构。
char input[256] = "' or '1'='1";
char sql[512];
snprintf(sql, sizeof sql, "select * from account where name = '%s'", input);这段拼出来是 select * from account where name = '' or '1'='1',where 条件恒真,整张表都能被读出来。mysql_real_escape_string 能转义字符串里的特殊字符,缓冲区按 2 * sizeof(input) + 1 准备:
char escaped[2 * sizeof(input) + 1];
mysql_real_escape_string(conn, escaped, input, (unsigned long)strlen(input));它必须在连接建立之后调用;它管不了“把变量拼进表名、列名、排序方向”这类结构注入。真正稳的做法是预处理语句,把语句结构和参数分开:
int insert_account(MYSQL *conn, int id, const char *name, double blance)
{
MYSQL_STMT *stmt = mysql_stmt_init(conn);
if (stmt == NULL) {
return 1;
}
const char *sql = "insert into account (id, name, blance) values (?, ?, ?)";
if (mysql_stmt_prepare(stmt, sql, (unsigned long)strlen(sql)) != 0) {
fprintf(stderr, "prepare: %s\n", mysql_stmt_error(stmt));
mysql_stmt_close(stmt);
return 1;
}
MYSQL_BIND bind[3];
memset(bind, 0, sizeof bind);
bind[0].buffer_type = MYSQL_TYPE_LONG;
bind[0].buffer = &id;
bind[1].buffer_type = MYSQL_TYPE_STRING;
bind[1].buffer = (void *)name;
bind[1].buffer_length = (unsigned long)strlen(name);
bind[2].buffer_type = MYSQL_TYPE_DOUBLE;
bind[2].buffer = &blance;
if (mysql_stmt_bind_param(stmt, bind) != 0) {
fprintf(stderr, "bind: %s\n", mysql_stmt_error(stmt));
mysql_stmt_close(stmt);
return 1;
}
if (mysql_stmt_execute(stmt) != 0) {
fprintf(stderr, "execute: %s\n", mysql_stmt_error(stmt));
mysql_stmt_close(stmt);
return 1;
}
mysql_stmt_close(stmt);
return 0;
}参数和语句结构分开传,服务端只解析一次,值不会变成 SQL 语法的一部分。
还没有评论 — 第一条由你来留。