在企业级应用中，C++ 常用于对性能要求高的模块进行数据持久化。本文聚焦 C++ 如何连接 MySQL 数据库，并通过 MySQL Connector/C++ 的使用教程与实战代码，带你走过从环境准备到简单查询的完整流程。
1. 准备工作与环境搭建
第一步是搭建数据库环境，以及获取适用于你开发环境的 Connector/C++。MySQL 数据库应已安装并可连接，随后下载并安装 MySQL Connector/C++，以获得 C++ 层面的 API 支持。
在 Windows、Linux、macOS 上的具体步骤略有差异，但核心原则是一致的：安装 MySQL Server、获取 Connector/C++ 的二进制或源代码，并确保头文件与库文件在编译时可发现。
1.1 安装 MySQL Connector/C++ 的获取方式
官方提供了多种获取方式，包括预构建的二进制包和源代码编译。选择合适的版本（8.0 系列较为常用），并准备好必要的依赖库，例如 pthread、libstdc++、cmake。
解压或安装完成后，记下 include 目录和 lib 目录，后续编译时需要将其传给编译器和链接器。
2. MySQL Connector/C++ 的核心概念
使用 Connector/C++，你将面向一组核心对象：Driver、Connection、Statement、ResultSet，以及 PreparedStatement。这些对象共同完成从连接、执行 SQL，到获取结果的完整流程。
常见的工作流程是：获取驱动实例 -> 建立连接 -> 创建语句对象 -> 执行 SQL -> 遍历结果集。错误通过 SQLException 捕获并处理。
2.1 关键对象与工作流程
Driver 是连接的入口，Connection 持有会话信息，Statement/PreparedStatement 用于 SQL 的执行，ResultSet 保存查询结果。
在实际项目中，善用 异常处理 和 资源释放，避免连接泄漏。
3. 在 C++ 项目中引入与配置
为了让编译器找到头文件和链接到库，需在构建配置中添加相应的路径。正确的 include 路径和 lib 路径是成功编译的关键。
另外，目标平台的兼容性（如 x86_64、arm64）也会影响你选择的 Connector/C++ 版本和依赖库。
3.1 配置编译与链接参数
一个常见的编译命令形式是：-I/path/to/mysql/include、-L/path/to/mysql/lib、-lmysqlcppconn，并确保在运行时能找到对应的动态库。
// 示例命令（Linux/macOS，需替换实际路径）
g++ -std=c++17 -I/usr/include/mysql -L/usr/lib -lmysqlcppconn main.cpp -o app
在 Windows 下，可能需要通过 Visual Studio 的附加包含目录和附加库目录，或者使用 CMake 来管理依赖。
4. 示例：连接数据库并执行查询
以下代码演示如何使用 Connector/C++ 建立连接、创建语句、执行查询，并遍历结果。注意替换主机、用户名、密码与数据库名。
这个示例适合快速验证环境是否配置正确。
4.1 简单查询示例
#include <iostream>
#include <memory>
#include <cppconn/driver.h>
#include <cppconn/exception.h>
#include <cppconn/prepared_statement.h>
#include <cppconn/resultset.h>
#include <cppconn/statement.h>
#include <mysql_driver.h>
#include <mysql_connection.h>int main() {try {// 1) 获取驱动sql::Driver *driver = sql::mysql::get_driver_instance();// 2) 建立连接std::unique_ptr<sql::Connection> con(driver->connect("tcp://127.0.0.1:3306", "root", "password"));// 3) 选择数据库con->setSchema("testdb");// 4) 创建语句对象并执行查询std::unique_ptr<sql::Statement> stmt(con->createStatement());std::unique_ptr<sql::ResultSet> res(stmt->executeQuery("SELECT id, name FROM users LIMIT 5"));while (res->next()) {std::cout << res->getInt("id") << " - " << res->getString("name") << std::endl;}} catch (sql::SQLException &e) {std::cerr <= "MySQL error: " < e.what() < std::endl;return 1;}return 0;
}
4.2 使用参数化查询
使用 PreparedStatement 可以避免 SQL 注入并提高性能，下面是一个参数化查询示例。
#include <cppconn/prepared_statement.h>
...
std::unique_ptr<sql::PreparedStatement> pstmt(con->prepareStatement("SELECT id, name FROM users WHERE age > ? AND status = ?"));
pstmt->setInt(1, 18);
pstmt->setString(2, "active");
std::unique_ptr<sql::ResultSet> rs(pstmt->executeQuery());while (rs->next()) {std::cout << rs->getInt("id") << " - " << rs->getString("name") << std::endl;
}
5. 高级话题
在实际应用中，除了基本的连接和查询外，可能还需要考虑事务、批量执行和错误恢复等。
Connector/C++ 提供 事务控制、自动提交与显式提交 的能力，以及对异常的处理策略。
5.1 事务基础与错误处理
使用 BEGIN / COMMIT / ROLLBACK 控制事务，以及通过 SQLException 的错误信息进行回滚策略设计。
在开发阶段，开启/关闭自动提交 的设置要与业务需求匹配，避免未提交的变更造成数据不一致。
6. 常见问题与排错要点
在集成过程中，可能会遇到诸如 找不到头文件、链接错误、运行时找不到动态库 等问题。以下是排错要点。
检查依赖版本与平台兼容性、确保 库路径 与可执行文件的运行时路径一致。
6.1 连接失败排查
先确认 MySQL 服务正在监听目标端口，防火墙和地址绑定是否允许连接。其次，检查 用户名、密码、数据库名是否正确。
6.2 环境变量与库路径
确保在运行时能找到动态库，可以通过 LD_LIBRARY_PATH（Linux/macOS）或 PATH（Windows）来指定。
