1. 官网及版本
1.1. 网址
官方文档 - 安装编译构建：
https://dev.mysql.com/doc/connector-cpp/9.3/en/
官方文档 - 使用案例：
https://dev.mysql.com/doc/dev/connector-cpp/latest/
下载地址：
https://dev.mysql.com/downloads/connector/cpp/
1.2. 版本变化(个人总结)
目前有3个大版本，1.x、8.x、9.x，1.x基本不再使用，一般至少会选择 8.x+。
Connector C++的早期版本依赖Boost库，从1.x开始，到8.x减少使用，再到9.x完全移除。
其中，8.x版本比较乱，从1.x~8.0.22，需要安装Boost库；从8.0.23开始，不需要安装Boost库。
其中，从8.1.0开始，不再提供32位版本，需要的话，自行编译。
其中，从9.x版本开始，附加依赖项区别于8.x的（mysqlcppconn.dll和mysqlcppconn8.dll），而是改为（mysqlcppconn.dll和mysqlcppconnx.dll）。
2. 下载
2.1. 打开下载地址，选择版本
Connector C++安装包种类说明：
根据需要下载对应的版本，推荐把四种全部下载，后面还要配置通用多平台。
2.2. 避坑说明
有坑：Connector C++的Debug、Release需要与Visual Studio的Debug、Release 一一对应，官网没有特别说明，初学者容易入坑。
3. 安装
3.1. 单平台模式安装(winx64+Release)
3.1.1. 解压
先把mysql-connector-c++-8.0.30-winx64.zip解压到D:\software\MySQL\mysql-connector-c++-8.0.30.winx64，再重命名为mysql-connector-c++-8.0.30.single。
3.1.2. 配置VS2022
- 先将原本的Debug改为Release
- 点击项目，右键属性，进入属性页
- C/C++ → 附加包含目录
- 将 D:\software\MySQL\mysql-connector-c++-8.0.30.single\include 加到附加包含目录
- 链接器→附加库目录
- 将 D:\software\MySQL\mysql-connector-c++-8.0.30.single\lib64\vs14 加到附加库目录
- 链接器→输入→附加依赖项
- 将 mysqlcppconn.lib;mysqlcppconn
- 应用、确定
- 完成！
3.2. 多平台模式安装
3.2.1. 准备工作
- 先把之前下载的4个包都解压；
- 新建一个文件夹mysql-connector-c++-8.0.30.all，用于存放4个合并包的位置；
- 2个Release包按照debug包，调整目录结构；
- 2个debug包中文件夹名由debug改为Debug；
- 4个包合并到mysql-connector-c++-8.0.30.all。
3.2.2. 创建VS项目属性表文件
<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
<ImportGroup Label="PropertySheets" />
<PropertyGroup>
<MYSQL_CPPCONN_DIR>D:\software\MySQL\mysql-connector-c++-8.0.30.all</MYSQL_CPPCONN_DIR>
<!--设置统一输出目录-->
<OutDir>$(SolutionDir)\$(Platform)\$(Configuration)\</OutDir>
</PropertyGroup>
<ItemDefinitionGroup>
<ClCompile>
<!--相对于附加包含目录-->
<AdditionalIncludeDirectories>$(MYSQL_CPPCONN_DIR)\include;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
<!--增加额外编译选项，防止出现乱码-->
<AdditionalOptions>/utf-8 %(AdditionalOptions)</AdditionalOptions>
</ClCompile>
<Link>
<!-- Win32条件下附加库目录 -->
<AdditionalLibraryDirectories Condition="'$(Platform)'=='Win32'">$(MYSQL_CPPCONN_DIR)\lib\vs14\$(Configuration);%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
<!-- x64条件下附加库目录 -->
<AdditionalLibraryDirectories Condition="'$(Platform)'=='x64'">$(MYSQL_CPPCONN_DIR)\lib64\vs14\$(Configuration);%(AdditionalLibraryDirectories)</AdditionalLibraryDirectories>
<!--附加依赖项-->
<AdditionalDependencies>mysqlcppconn.lib;mysqlcppconn8.lib;%(AdditionalDependencies)</AdditionalDependencies>
</Link>
<!--生成后事件，用于将依赖dll复制到目标目录-->
<PostBuildEvent>
<Command>
if "$(Platform)" == "Win32" (
xcopy /y /i "$(MYSQL_CPPCONN_DIR)\lib\*.dll" "$(TargetDir)"
xcopy /y /i "$(MYSQL_CPPCONN_DIR)\lib\$(Configuration)\*.dll" "$(TargetDir)"
) else (
xcopy /y /i "$(MYSQL_CPPCONN_DIR)\lib64\*.dll" "$(TargetDir)"
xcopy /y /i "$(MYSQL_CPPCONN_DIR)\lib64\$(Configuration)\*.dll" "$(TargetDir)"
)</Command>
</PostBuildEvent>
</ItemDefinitionGroup>
</Project>3.2.3. 运行效果
4. 测试代码
#include <mysql/jdbc.h>
#include <string>
#include <iostream>
#include <windows.h>
using namespace std;
using namespace sql;
using namespace mysql;
int main() {
SetConsoleCP(65001);
SetConsoleOutputCP(65001);
try {
cout << "1. 正在加载驱动..." << endl;
MySQL_Driver* driver = get_mysql_driver_instance();
cout << "2. 驱动版本：" << driver->getMajorVersion()
<< "." << driver->getMinorVersion()
<< "." << driver->getPatchVersion() << endl;
cout << "3. 尝试连接数据库..." << endl;
unique_ptr<Connection> conn{
driver->connect("tcp://127.0.0.1:3306","root","root")
};
cout << "4. 切换数据库..." << endl;
conn->setSchema("test");
cout << "5. 执行实际查询..." << endl;
unique_ptr<Statement> stmt{ conn->createStatement() };
unique_ptr<ResultSet> rs{ stmt->executeQuery("SELECT * FROM users;") };
while (rs->next()) {
int id = rs->getInt("id");
string name = rs->getString("username");
string pwd = rs->getString("password");
cout << "ID: " << id
<< ", Username: " << name
<< ", Password: " << pwd << endl;
}
}
catch (SQLException& e) {
cerr << "\n!!! SQL异常 !!!\n"
<< "错误信息: " << e.what() << "\n"
<< "错误代码: " << e.getErrorCode() << endl;
return EXIT_FAILURE;
}
catch (std::exception& e) {
cerr << "标准异常: " << e.what() << endl;
return EXIT_FAILURE;
}
catch (...) {
cerr << "未知异常！" << endl;
return EXIT_FAILURE;
}
getchar();
return EXIT_SUCCESS;
}5. 错误总结
5.1. Unable to connect to localhost 1367760
代码
cerr << "\n!!! SQL异常 !!!\n"
<< "错误信息: " << e.what() << "\n"
<< "错误代码: " << e.getErrorCode() << endl;
return EXIT_FAILURE;
原因：在VS2022 Debug模式下，引用Release MySQL connector包，导致连接失败。
5.2. 0x00007FFD96D42070 (ucrtbased.dll)处(位于 xxx.exe 中)引发的异常: 0xC0000005: 读取位置 0x00007F0045444F4D 时发生访问冲突。
代码
cerr << "\n!!! SQL异常 !!!\n"
<< "错误信息: " << e.what() << "\n"
<< "错误代码: " << e.getErrorCode() << "\n"
<< "SQL状态: " << e.getSQLState() << endl;
return EXIT_FAILURE;
原因：也是在VS2022 Debug模式下，引用Release MySQL connector包，同时，还增加了getSQLState()的调用导致的。
5.3. 无法打开包括文件: “boost/shared_ptr.hpp”: No such file or directory
原因：使用的是低版本的MySQL connector包(<8.0.23)，需要额外配置Boost库
6. 另外乱码问题
6.1. 编译选项
<!--增加额外编译选项，防止出现乱码-->
<AdditionalOptions>/utf-8 %(AdditionalOptions)</AdditionalOptions>6.2. 代码中设置控制台编码
// 设置控制台编码格式为UTF-8
SetConsoleCP(65001);
SetConsoleOutputCP(65001);6.3. VS2022中文件编码
