Windows下CMake构建应用时mysql-connector-cpp链接失败求助

以下是针对你的问题的具体排查和解决步骤：

• 确认MySQL Connector/C++库被正确链接
  MSI安装的MySQL Connector/C++不会自动被CMake识别，仅添加包含目录不足以完成链接，必须明确指定库文件路径：

  1. 找到你的MySQL Connector安装目录（例如C:\Program Files\MySQL\MySQL Connector C++ 8.0），其下lib64\vsXX（XX对应你的VS版本，如vs17对应VS2022）文件夹中，包含带d后缀的Debug版本库（如mysqlcppconn8d.lib）和无后缀的Release版本库。
  2. 在CMakeLists.txt中针对你的目标添加链接配置，区分构建类型：

     # 替换为你的实际安装路径
     set(MYSQL_CONNECTOR_ROOT "C:/Program Files/MySQL/MySQL Connector C++ 8.0")
     target_include_directories(你的目标名称 PRIVATE "${MYSQL_CONNECTOR_ROOT}/include")
     
     # 匹配Debug/Release配置
     if(CMAKE_BUILD_TYPE STREQUAL "Debug")
         target_link_libraries(你的目标名称 PRIVATE "${MYSQL_CONNECTOR_ROOT}/lib64/vs17/mysqlcppconn8d.lib")
     else()
         target_link_libraries(你的目标名称 PRIVATE "${MYSQL_CONNECTOR_ROOT}/lib64/vs17/mysqlcppconn8.lib")
     endif()
     

  若想使用find_package简化配置，需将MySQL Connector安装目录下的lib/cmake文件夹添加到CMAKE_PREFIX_PATH，例如在CMakeLists.txt开头添加：

  set(CMAKE_PREFIX_PATH "${CMAKE_PREFIX_PATH};C:/Program Files/MySQL/MySQL Connector C++ 8.0/lib/cmake")
  find_package(MySQLConnectorCPP REQUIRED)
  target_link_libraries(你的目标名称 PRIVATE MySQLConnectorCPP::mysqlcppconn8)
  

• 严格匹配Debug/Release构建配置
  Windows下Debug和Release库不能混用：

  1. 确认VSCode中CMake的构建类型（cmake.buildType）与你链接的MySQL库版本一致。
  2. Vcpkg管理的Nlohmann Json和Curl会自动匹配当前构建类型，需确保MySQL库版本同步。

• 校验库的系统位数匹配
  若你的系统是64位，必须安装并链接64位版本的MySQL Connector/C++，避免与Vcpkg默认的64位目标平台冲突。

• 统一使用Vcpkg管理MySQL Connector/C++
  既然已用Vcpkg管理其他依赖，推荐直接通过Vcpkg安装MySQL Connector/C++，避免手动配置的兼容性问题：

  1. 在vcpkg.json中添加依赖：

     {
       "dependencies": [
         "nlohmann-json",
         "curl",
         "mysql-connector-cpp"
       ]
     }
     

  2. 运行vcpkg install安装依赖。
  3. 在CMakeLists.txt中直接引用：

     find_package(mysql-connector-cpp REQUIRED)
     target_link_libraries(你的目标名称 PRIVATE mysql-connector-cpp::mysql-connector-cpp)
     

  这种方式会自动处理包含目录、库链接以及Debug/Release版本匹配。

• 检查动态库运行时依赖（补充）
  构建成功后，需将MySQL Connector对应的DLL文件（如mysqlcppconn8d.dll或mysqlcppconn8.dll）复制到可执行文件输出目录，否则运行时会出现缺失依赖的错误。

内容的提问来源于stack exchange，提问作者Sorin Tudose