VS2013下编译MySQL Connector/C++ 1.1.8并适配双平台

简介面向需要在 Visual Studio 2013 中编译并使用 MySQL Connector/C 的 Windows C 开发者这份资源把 32 位与 64 位连接库的构建过程整合成可直接参考的工程包重点解决 Windows 下头文件与依赖库配置、lib/dll 生成等常见问题。压缩包共 63 个文件约 24.98MB包含 21 个头文件、20 个库文件、9 个 DLL 文件、示例源码与工程配置文件头文件覆盖驱动、连接、预处理语句、结果集等关键接口库文件按 debug/release、win32/x64 分类另外保留 sln 与 vcxproj 工程文件可直接打开查看或调整链接器、包含目录设置。核心示例 MysqlTest 演示了连接数据库、执行 SQL、遍历结果集以及关闭连接的完整流程同时工程中还保留了 pdb、exp、ilk 等构建产物便于查看符号和定位链接错误。已有 510 人学习下载适合希望快速在 VS2013 中集成 MySQL 数据库能力、又不想从零摸索编译配置的初学者也可作为已有项目切换 32 位或 64 位构建时的对照参考。 老项目还在用VS2013的时候最麻烦的往往不是业务逻辑而是第三方库的适配。前阵子我接手一个Win32/Win64双平台的数据同步模块数据库要从SQLite切到MySQL于是面对一个很现实的问题怎么在VS2013里把Mysql Connector C/C编译出来并保证两个平台都能正常调用。官方预编译包不是没有但版本新了编译器要求也跟着提高VS2013根本扛不住版本旧了又找不到官方二进制。最后我直接从源码编译把win32/win64两套库全部做出来再用一段示例代码验证整条链路可用。这篇博客就是完整记录这次编译过程和踩坑经历适合还在维护老工程但需要对接MySQL的C开发同学也适合想搞懂Connector/C依赖关系的人。1. 项目概述与版本选型思路1.1 核心需求拆解编译一个库其实包含好几件事。表面需求是用VS2013编译Mysql Connector C/C但拆开看至少有三个隐性要求。一是编译器兼容性VS2013对C11的支持不完整很多新版本库的源码用到了现代C特性直接编译就是海量报错所以必须挑一个对编译器宽容的版本。二是平台区分win32和win64要产出两套完全独立的二进制构建目录不能混用。三是工程可用性编译完的库必须能被业务工程引用还要有能跑的示例验证连接、查询、结果集遍历这些基本功能。如果只看标题直接下载源码编译很容易在依赖环节卡住。1.2 为什么选择Connector/C 1.1.x而不是新版Mysql Connector/C有两个主要分支。一个是1.1.xAPI风格接近老JDBC使用sql::Connection、sql::Statement、sql::ResultSet这套对象模型编译期依赖Boost头文件对编译器要求相对宽松是VS2013环境下的合理选择。另一个是2.x之后的新架构加入了X DevAPI、X Protocol支持代码大量使用C11甚至更新的特性VS2013编译起来非常痛苦官方新版本也不再兼容老编译器。即便8.0/9.0连接器保留了经典API底层构建要求也提高了不少。当时我直接选1.1.x分支的1.1.8版本算是老工程里最成熟的方案。1.3 依赖项梳理Boost、MySQL客户端、CMake动手之前要确认三块依赖。第一是MySQL客户端库它干的是底层网络协议和SQL协议的活Connector/C只是在其上封装出一层C对象。我们需要MySQL安装目录下的include和lib以及libmysql.dll。第二是Boost1.1.x源码里会用到boost/property_tree之类的头文件好在这些功能只依赖头文件不需要预编译Boost库省了编译Boost的时间。第三是CMake负责生成VS2013解决方案。CMake版本不能太新3.19左右对VS2013生成器的支持最省心太新的CMake生成器策略已经向新版本Visual Studio偏移反而容易出幺蛾子。2. 环境准备与依赖处理2.1 VS2013补丁与CMake版本搭配VS2013必须把补丁打到Update 5。老项目机器如果长期没更新编译器基础版本很旧Connector/C 1.1.8源码是从比较老的时代延续下来的没打补丁会冒出一堆C2664、C2440这类编译错误都是标准库和链接器层面的兼容问题。CMake建议装3.19.8安装时勾选添加到系统PATH后面命令行直接用。如果你机器上已经装了新版CMake也没关系只要在项目构建目录里显式指定cmake版本路径即可。另外构建机和部署机可以是不同机器但一定要保证编译产物和运行库的版本匹配。2.2 Boost头文件准备Boost只需要解压不需要编译出lib。我下载的是boost_1_59_0解压到C:\thirdparty\boost_1_59_0。路径里不要有空格不要放在C:\Program Files这类带空格的目录下否则CMake解析路径时会很麻烦。判断是否准备好直接看C:\thirdparty\boost_1_59_0\boost\version.hpp存不存在。CMake配置时用-DBOOST_ROOT指定该目录如果还是找不到检查命令行里路径有没有写成反斜杠建议统一用正斜杠。2.3 获取MySQL客户端头文件与导入库获取MySQL客户端有两种方式。一种是安装完整MySQL Server安装完自带include和lib目录适合已经在调试环境的机器另一种是单独下载MySQL Connector/C的ZIP包结构简单解压就是include和lib。我用的本机正好装了MySQL Server 8.0所以直接指定到安装目录。需要注意MySQL Server客户端库的位数要和目标工程一致32位程序必须搭配32位libmysql.dll64位程序必须搭配64位这是一个非常容易踩的坑后面还会再强调。3. win32/win64 全流程编译实操3.1 用CMake生成双平台解决方案源码解压到C:\work\mysql-connector-c-1.1.8在源码外新建build32和build64两个目录。因为CMake会把生成的解决方案、中间文件和缓存都放在build目录如果共用目录切平台时总会残留干扰物理隔离最省心。进入build32目录执行cmake -G Visual Studio 12 2013 ^ -DBOOST_ROOTC:/thirdparty/boost_1_59_0 ^ -DMYSQL_DIRC:/Program Files/MySQL/MySQL Server 8.0 ^ -DWITH_SSLOFF ^ -DBUILD_STATICOFF ^ ..64位在build64目录执行cmake -G Visual Studio 12 2013 Win64 ^ -DBOOST_ROOTC:/thirdparty/boost_1_59_0 ^ -DMYSQL_DIRC:/Program Files/MySQL/MySQL Server 8.0 ^ -DWITH_SSLOFF ^ -DBUILD_STATICOFF ^ ..参数含义逐个说清楚。Visual Studio 12 2013就是VS2013的生成器名称Win64后缀对应64位目标。BOOST_ROOT指向Boost解压目录。MYSQL_DIR是让CMake去MySQL安装目录里自动找头文件和库文件如果你的路径结构比较特殊建议手动指定MYSQL_INCLUDE_DIR和MYSQL_LIB_DIR。WITH_SSLOFF表示不启用OpenSSL省掉SSL依赖本地环境临时测试完全够用。BUILD_STATICOFF表示生成动态库版本如果我们还想顺便拿到静态库可以改成ON但编译时间会变长。命令执行成功后两个build目录下都会出现mysql_connector.sln可以进VS2013了。3.2 在VS2013中编译并确认产物打开对应build目录下的解决方案工具栏平台要选对build32生成的工程选Win32build64生成的选x64别选错了。配置建议选ReleaseDebug版虽然也能编但业务部署时Debug会依赖额外调试运行库不划算。右键项目列表里的mysqlcppconn项目点生成等待输出窗口显示成功。如果BUILD_STATIC设为ON就还要把mysqlcppconn-static也生成一遍。生成产物不一定都在同一个地方不同源码版本输出路径不同最快的办法是在项目属性-常规-输出目录里看。我这边动态库的产物在构建目录下libmysql目录的对应配置文件夹里里面能看到mysqlcppconn.dll和mysqlcppconn.lib。3.3 编译产物的目录整理编译完别急着关。本文还有配套的精品资源点击获取