推荐使用MySQL官方Connector/C++库连接和操作MySQL数据库。首先下载并安装Connector/C++,配置头文件和库路径;然后在代码中包含相应头文件,使用Driver、Connection、Statement等对象建立连接并执行SQL查询;最后注意编译时链接mysqlcppconn库,并处理运行时依赖问题。示例代码展示了通过Classic API连接数据库、执行查询并输出结果的完整流程。

要在C++中连接和操作MySQL数据库,推荐使用MySQL官方提供的Connector/C++库。它是一个面向C++的MySQL驱动程序,允许开发者通过标准的类似JDBC的API来访问MySQL数据库。
1. 安装MySQL Connector/C++
在开始之前,确保你的系统已经安装了MySQL Server,并下载并安装MySQL Connector/C++:
- 前往 https://dev.mysql.com/downloads/connector/cpp/ 下载适合你系统的版本(如Windows ZIP或Linux DEB/RPM包)
- 解压或安装后,你会得到头文件(include目录)、库文件(lib目录)以及可能需要的DLL(Windows下)
- 将 include 目录添加到编译器的头文件搜索路径,将 lib 目录添加到库路径
2. 配置开发环境(以g++为例)
假设你使用的是Linux或WSL,且已安装g++、cmake和MySQL Connector/C++。
编译时需链接以下库:
立即学习“C++免费学习笔记(深入)”;
- mysqlcppconn8(动态库名称,对应 libmysqlcppconn8.so 或 .dll)
编译命令示例:
<font face="Courier New"> g++ -o main main.cpp -I/usr/local/mysql/include -L/usr/local/mysql/lib -lmysqlcppconn </font>
如果你使用的是静态库,请确认链接正确的版本并处理依赖项。
3. 编写C++代码连接MySQL
以下是一个使用MySQL Connector/C++ Classic API 连接数据库并执行查询的简单示例:
<font face="Courier New">
#include <mysqlx/xdevapi.h>
#include <mysql_connection.h>
#include <cppconn/driver.h>
#include <cppconn/exception.h>
#include <cppconn/resultset.h>
#include <cppconn/statement.h>
#include <iostream>
using namespace std;
int main() {
sql::Driver *driver;
sql::Connection *con;
sql::Statement *stmt;
sql::ResultSet *res;
try {
// 获取数据库驱动
driver = get_driver_instance();
// 建立连接 (主机, 用户名, 密码)
con = driver->connect("tcp://127.0.0.1:3306", "root", "your_password");
// 选择数据库
con->setSchema("testdb");
// 创建语句对象
stmt = con->createStatement();
// 执行查询
res = stmt->executeQuery("SELECT id, name FROM users");
// 遍历结果
while (res->next()) {
cout << "ID: " << res->getInt("id")
<< ", Name: " << res->getString("name") << endl;
}
// 清理资源
delete res;
delete stmt;
delete con;
} catch (sql::SQLException &e) {
cout << "SQLException in " << __FILE__;
cout << " (" << __FUNCTION__ << ") on line " << __LINE__ << endl;
cout << "Error: " << e.what();
cout << " [Error Code]: " << e.getErrorCode() << endl;
}
return 0;
}
</font>
4. 处理常见问题
- 找不到头文件:检查是否正确设置了-I参数指向Connector/C++的include目录
- 链接错误:确认-lmysqlcppconn拼写正确,并且库文件存在于指定路径
-
运行时报错无法加载共享库(Linux):将.so文件所在路径加入LD_LIBRARY_PATH,例如:
export LD_LIBRARY_PATH=/usr/local/mysql/lib:$LD_LIBRARY_PATH - 连接被拒绝:确认MySQL服务正在运行,用户名密码正确,端口无误
基本上就这些。只要配置好环境,用Connector/C++操作MySQL并不复杂,但容易忽略链接和运行时依赖问题。










