C++如何连接MySQL数据库?(API使用教程)

推荐使用MySQL Connector/C++连接MySQL数据库,因其面向对象、支持预处理语句和事务;C API更底层、轻量但需手动管理资源。环境配置需按平台安装对应驱动,注意协议兼容性与字符集设置。

用C++连接MySQL数据库,主流方式是使用官方提供的 MySQL Connector/C++(推荐新项目)或更底层的 MySQL C API(libmysqlclient)。两者区别明显:前者面向对象、支持预处理语句和事务,语法接近Java JDBC;后者是纯C风格,轻量但需手动管理资源和SQL拼接,适合嵌入式或对性能极致要求的场景。

准备环境:安装驱动与依赖

Windows下可直接下载 MySQL Connector/C++ 的 ZIP 包(含头文件、DLL 和静态库),解压后配置包含目录和链接库路径;Linux 推荐用包管理器安装:

  • Ubuntu/Debian:sudo apt install libmysqlcppconn-dev libmysqlclient-dev
  • CentOS/RHEL:sudo yum install mysql-connector-c++-devel mysql-devel

注意:Connector/C++ 8.0+ 默认使用 X DevAPI(JSON over X Protocol),若要连接传统 MySQL 协议,需启用 legacy mode 或降级到 1.1.x 版本(已停止维护但稳定)。编译时链接 -lmysqlcppconn(C++)或 -lmysqlclient(C API)。

使用 MySQL Connector/C++ 连接并查询

这是更现代、安全且易维护的方式。关键步骤:初始化驱动、获取连接、创建语句、执行 SQL、处理结果集。

  • 包含头文件:#include #include #include
  • 通过 sql::mysql::MySQL_Driver::get_mysql_driver_instance() 获取驱动实例
  • driver->connect("tcp://127.0.0.1:3306", "user", "pass") 建立连接(支持 tcp、unix socket、ssl 参数)
  • 设置自动提交:con->setAutoCommit(0)(开启事务时必需)
  • 执行查询:std::unique_ptr<:resultset> res(stmt->executeQuery("SELECT id, name FROM users"))

注意:所有对象(Connection、Statement、ResultSet)都需显式释放或由智能指针管理,避免内存泄漏;字符串参数建议用 sql::SQLString 类型,兼容 UTF-8。

使用 MySQL C API(libmysqlclient)直连

适合已有 C 项目集成或需要细粒度控制的场景。它不提供类封装,所有操作围绕 MYSQL* 指针展开。

  • 初始化:MYSQL *conn = mysql_init(NULL),失败返回 NULL
  • 连接:mysql_real_connect(conn, "127.0.0.1", "user", "pass", "db_name", 3306, NULL, 0)
  • 设置字符集(防止中文乱码):mysql_set_character_set(conn, "utf8mb4")
  • 执行查询:mysql_query(conn, "INSERT INTO t VALUES (1, 'hello')")
  • 获取结果:MYSQL_RES *res = mysql_store_result(conn),逐行读取用 mysql_fetch_row(res)

必须调用 mysql_free_result(res)mysql_close(conn) 清理资源;错误检查不能省略——每次调用后查 mysql_errno(conn)

常见问题与避坑提示

连接失败最常因权限、网络或字符集引起。确保 MySQL 用户有远程访问权限(如 CREATE USER 'app'@'%' IDENTIFIED BY 'pwd'; GRANT SELECT ON db.* TO 'app'@'%'; FLUSH PRIVILEGES;);防火墙放行 3306 端口;客户端和服务端字符集统一为 utf8mb4;Linux 下动态链接时确认 LD_LIBRARY_PATH 包含 MySQL 库路径。

预处理语句防 SQL 注入是硬性建议——Connector/C++ 用 std::unique_ptr<:preparedstatement>,C API 用 mysql_stmt_prepare();避免 sprintf 拼接 SQL 字符串。