使用MySQL Connector/C++连接数据库需先安装开发库,配置编译环境并链接相应库文件,然后通过X DevAPI或C API建立连接。推荐使用X DevAPI进行现代C++开发,示例代码展示了如何连接、执行查询及处理异常,也可选用经典C API实现更底层控制。

要在C++中连接MySQL数据库,最常用的方法是使用MySQL官方提供的C API库——MySQL Connector/C++。以下是详细的连接步骤和示例代码,帮助你快速实现C++与MySQL的连接。
1. 安装MySQL Connector/C++
在开始前,确保你的系统已安装MySQL开发库:
- Windows:下载并安装 MySQL Installer,选择包含 MySQL Connector/C++ 的组件。
-
Linux(Ubuntu/Debian):运行命令安装依赖库:
sudo apt-get install libmysqlcppconn-dev
-
macOS:使用Homebrew安装:
brew install mysql-connector-c++
2. 配置编译环境
编译C++程序时需要链接MySQL Connector库。假设你的源文件名为connect_mysql.cpp,编译命令如下:
g++ -o connect_mysql connect_mysql.cpp -lmysqlcppconn
如果提示找不到头文件或库路径,可能需要手动指定路径:
立即学习“C++免费学习笔记(深入)”;
g++ -I/usr/include/mysql -L/usr/lib -lmysqlcppconn connect_mysql.cpp -o connect_mysql
3. C++连接MySQL示例代码
以下是一个简单的连接示例,展示如何建立连接并执行一条查询:
#include <iostream>
#include <mysqlx/xdevapi.h> // 使用X DevAPI(推荐)
using namespace std;
using namespace mysqlx;
int main() {
try {
// 建立会话:host, user, password
Session session("localhost", "root", "your_password");
// 检查是否连接成功
cout << "成功连接到MySQL服务器!" << endl;
// 获取数据库对象(例如 testdb)
Schema db = session.getSchema("testdb");
// 执行SQL查询
SqlResult result = session.sql("SELECT 'Hello, MySQL!'").execute();
Row row = result.fetchOne();
cout << "查询结果: " << row[0] << endl;
// 关闭会话
session.close();
}
catch (const Error &err) {
cerr << "MySQL错误: " << err.what() << endl;
return 1;
}
catch (const std::exception &ex) {
cerr << "异常: " << ex.what() << endl;
return 1;
}
return 0;
}
注意:上面使用的是现代的X DevAPI(基于文档存储和SQL),适用于MySQL 8.0+。如果你使用传统SQL连接,也可以采用经典的<mysql/mysql.h> C风格接口。
4. 使用经典C API连接(可选)
若不想用C++ Connector,可直接使用MySQL C API(更底层但稳定):
#include <mysql.h>
#include <iostream>
using namespace std;
int main() {
MYSQL *conn;
conn = mysql_init(NULL);
if (!mysql_real_connect(conn, "localhost", "root", "your_password", "testdb", 3306, NULL, 0)) {
cerr << "连接失败: " << mysql_error(conn) << endl;
return 1;
}
cout << "MySQL连接成功!" << endl;
// 执行查询
if (mysql_query(conn, "SELECT DATABASE()")) {
cerr << "查询失败: " << mysql_error(conn) << endl;
} else {
MYSQL_RES *res = mysql_store_result(conn);
MYSQL_ROW row = mysql_fetch_row(res);
cout << "当前数据库: " << row[0] << endl;
mysql_free_result(res);
}
mysql_close(conn);
return 0;
}
编译时链接mysqlclient:
g++ -o connect_mysql connect_mysql.cpp -lmysqlclient
基本上就这些。选择合适的方式取决于你的项目需求和MySQL版本。推荐新项目使用MySQL Connector/C++ X DevAPI,功能更强且支持现代C++特性。











