怎么用C语言连接MySQL数据库服务器，连接步骤是什么？

C语言连接MySQL的核心路径是调用MySQL C API：安装客户端开发库、包含mysql.h、用mysql_init初始化句柄、用mysql_real_connect建立连接、执行SQL并处理结果集，最后按顺序释放资源。 Linux上通常安装libmysqlclient-dev并用-lmysqlclient链接；Windows上配置MySQL Connector/C的头文件、lib库和运行时的libmysql.dll。

环境准备：库、头文件和编译器缺一不可

C语言本身不带着数据库能力,它得通过客户端库去和MySQL说话，你写的代码只是“发指令”，真正完成网络通信、认证、结果集解析的是MySQL C API背后的客户端库，所以第一步不是急着写SQL，而是把编译环境配顺。

加载中

【C语言】连接MySQL数据库

清兰cc

2.6万28840

原视频地址

Linux下C程序连接MySQL怎么配置编译环境

在Debian/Ubuntu系上，安装开发包：

sudo apt update
sudo apt install libmysqlclient-dev gcc

在RHEL/CentOS系上，包名通常是mysql-devel或mariadb-devel：

sudo yum install mysql-devel gcc

装完后确认mysql.h存在，常见路径是/usr/include/mysql/mysql.h，编译时可以用mysql_config自动带出编译和链接参数：

gcc conn.c -o conn $(mysql_config --cflags --libs)

如果系统里没有mysql_config,也可以手动指定：

gcc conn.c -o conn -I/usr/include/mysql -lmysqlclient

这里的关键是-lmysqlclient，少了它就会出现undefined reference to mysql_init这类链接错误，业内专家指出，生产环境不要长期用root账号连接数据库，单独建一个最小权限账号更稳妥。

Windows上C语言连接MySQL需要哪些库

Windows下更常见的是MySQL Connector/C，下载安装后，重点配置三样东西：

• 头文件目录：包含mysql.h的include目录。
• 库目录：包含libmysql.lib的lib目录。
• 运行时库：libmysql.dll，需要放到程序运行目录或系统PATH里。

Visual Studio项目里，在“附加包含目录”加include路径，在“附加库目录”加lib路径，在“附加依赖项”填libmysql.lib，命令行编译则类似：

cl conn.c /I"C:\mysql-connector-c\include" /link /LIBPATH:"C:\mysql-connector-c\lib" libmysql.lib

常见坑是位数不匹配：x64程序必须链接x64的库，否则会出现LNK2019或运行时加载失败，部署时别忘了带上libmysql.dll。

C语言连接MySQL数据库步骤：从环境准备到第一个查询

连接流程其实很固定：初始化句柄、设置字符集、建立连接、执行SQL、取结果、释放资源，顺序别乱，尤其是释放顺序。

一个最小可运行的连接示例

#include <stdio.h>
#include <mysql/mysql.h>
int main(void) {
    MYSQL conn = mysql_init(NULL);
    if (conn == NULL) {
        fprintf(stderr, "mysql_init failed\n");
        return 1;
    }
    mysql_options(conn, MYSQL_SET_CHARSET_NAME, "utf8mb4");
    if (mysql_real_connect(conn, "127.0.0.1", "app_user", "app_pass",
                           "testdb", 3306, NULL, 0) == NULL) {
        fprintf(stderr, "connect error: %s\n", mysql_error(conn));
        mysql_close(conn);
        return 1;
    }
    printf("server version: %s\n", mysql_get_server_info(conn));
    mysql_close(conn);
    return 0;
}

这段代码里,3306是MySQL默认端口，utf8mb4是更稳妥的字符集选择，mysql_real_connect的参数依次是主机、用户、密码、数据库、端口、Unix套接字、客户端标志，本地连接可以写127.0.0.1，远程连接则换成服务器公网或内网地址。

连接远程MySQL服务器时的参数与网络检查

远程连接失败,先别怀疑代码，按下面顺序看：

1. 用mysql命令行验证账号密码和数据库名：
   mysql -h 服务器IP -P 3306 -u app_user -p testdb
2. 检查MySQL用户是否允许从你的客户端IP登录：
   SELECT user, host FROM mysql.user;
3. 检查服务器防火墙和云安全组是否放行3306。
4. 检查my.cnf里的bind-address是否只绑定了127.0.0.1。
5. 确认客户端库版本支持MySQL 8.0的认证方式。

据MySQL官方文档,MySQL 8.0默认认证插件是caching_sha2_password，老版本客户端库可能不认这个插件，报错类似“Authentication plugin ‘caching_sha2_password’ cannot be loaded”，优先升级客户端库，不要一上来就把用户改成老认证插件。

C语言操作MySQL增删改查示例与结果集处理

连接成功后,查询和写入都通过mysql_query发SQL，SELECT需要额外取结果集，INSERT/UPDATE/DELETE则看影响行数。

执行查询与遍历结果集

if (mysql_query(conn, "SELECT id, name FROM users LIMIT 3") != 0) {
    fprintf(stderr, "query error: %s\n", mysql_error(conn));
    return 1;
}
MYSQL_RES res = mysql_store_result(conn);
if (res == NULL) {
    fprintf(stderr, "store result error: %s\n", mysql_error(conn));
    return 1;
}
MYSQL_ROW row;
unsigned int field_count = mysql_num_fields(res);
while ((row = mysql_fetch_row(res)) != NULL) {
    for (unsigned int i = 0; i < field_count; i++) {
        printf("%s\t", row[i] ? row[i] : "NULL");
    }
    printf("\n");
}
mysql_free_result(res);

mysql_store_result会把整个结果集拉到客户端内存,适合结果量可控的场景，结果特别大时可以考虑mysql_use_result，但它要求你逐行取完，不能并发执行其他查询，字段为NULL时，mysql_fetch_row返回的对应指针就是NULL，打印前要判断。

写入数据与避免SQL注入

INSERT、UPDATE、DELETE用mysql_query直接执行，成功后用mysql_affected_rows看影响行数：

if (mysql_query(conn, "UPDATE users SET name='Tom' WHERE id=1") != 0) {
    fprintf(stderr, "update error: %s\n", mysql_error(conn));
}
printf("affected rows: %llu\n", mysql_affected_rows(conn));

拼接SQL时,用户输入必须转义，或者直接用预处理语句，行业共识认为，C程序里应优先使用mysql_stmt_init、mysql_stmt_prepare、mysql_stmt_bind_param这套预处理接口，而不是把变量直接拼进SQL字符串，预处理不仅能降低注入风险，也能减少反复解析SQL的开销。

资源释放顺序建议固定为：先mysql_free_result释放结果集，再mysql_close关闭连接，多线程程序里，每个线程用自己的MYSQL句柄，不要多个线程共享同一个连接；需要时调用mysql_thread_init和mysql_thread_end。

C语言连接远程MySQL服务器失败怎么排查

远程连接的问题通常集中在账号权限、网络可达性和认证插件三处，先拿错误码说话，比盲目改代码有效。

常见错误与处理方向

排查时先用命令行客户端跑通,再把同样的主机、端口、用户、密码填进C代码，命令行能通而C代码不通，多半是编译链接的库不对，或者运行时加载了另一个版本的客户端库，Linux下可以用ldd查看程序依赖，Windows下用Process Monitor看dll加载路径。

把开发库装对、连接参数写对、错误码看明白，C语言连接MySQL并不神秘，生产环境再补上预处理语句、最小权限账号和连接重试策略，稳定性会好很多。

C语言连接MySQL服务器常见问题Q&A

C语言连接MySQL数据库服务器需要付费吗？

MySQL Community Server和Connector/C社区版可以免费使用，遵循GPL等开源许可，若把闭源商业软件分发给第三方，需要评估Oracle的商业许可条款，商业许可费用以官方报价为准，多数内部项目使用社区版即可满足需求。

C语言连接MySQL和用Connector/C有什么区别？

MySQL C API是接口规范，libmysqlclient是官方客户端库的一种实现，Connector/C则是独立打包的C API库，两者函数名基本一致，Connector/C在Windows和跨平台部署时更省事，选择时看现有环境：Linux发行版仓库通常直接提供libmysqlclient开发包，Windows则常用Connector/C。

C语言连接MySQL数据库失败怎么排查？

先看mysql_error返回的具体错误码；再用mysql命令行客户端或nc测试网络和账号；接着检查用户host授权、防火墙、bind-address和认证插件；最后确认编译链接的库位数与运行环境一致，命令行能连上而程序连不上，优先检查链接库和运行时dll版本。