Visual Studio CLR项目中MySQL Connector C++连接失败问题求助

问题描述 #

在控制台C项目中，使用MySQL Connector C静态链接（mysqlcppconn-static.lib + STATIC_CONCPP预定义）能正常连接数据库，代码如下：

#include <iostream>
#include <string>
#include <mysql_connection.h>

#include <cppconn/driver.h>
#include <cppconn/exception.h>
#include <cppconn/prepared_statement.h>

const std::string server = "tcp://127.0.0.1:3306";
const std::string username = "root";
const std::string password = "root";

int main() {
    sql::Driver* driver = nullptr;
    sql::Connection* conn = nullptr;
    sql::Statement* stmt = nullptr;
    sql::PreparedStatement* pstmt = nullptr;
    sql::ResultSet* res = nullptr;
    int x;
    std::cin >> x;
    try {
        driver = get_driver_instance();
        conn = driver->connect(server, username, password);
        std::cout << "Connection Successful!";
        
    }
    catch (sql::SQLException& eSQL) {
        std::cerr << "Failed with exception: " << eSQL.what() << std::endl;
    }

    delete res;
    delete stmt;
    delete conn;
    return 0;
}

但在Windows Form CLR项目中，使用相同连接逻辑时：

• 沿用静态链接配置会出现大量LNK2038编译错误
• 改用动态链接库mysqlcppconn.lib后编译通过，但运行时抛出"Unable to connect to localhost"异常（数据库服务正常运行）

CLR项目中的连接代码：

private: System::Void btnConnect_Click(System::Object^ sender, System::EventArgs^ e) {
    const std::string server = "tcp://127.0.0.1:3306";
    const std::string username = "root";
    const std::string password = "root";

    sql::Driver* driver = nullptr;
    sql::Connection* conn = nullptr;
    sql::Statement* stmt = nullptr;
    sql::PreparedStatement* pstmt = nullptr;
    sql::ResultSet* res = nullptr;
    try {
        driver = get_driver_instance();
        conn = driver->connect(server, username, password);
        label_connection->Text = "Successful connection!";
    
    }
    catch (sql::SQLException& eSQL) {
        label_connection->Text = gcnew String(eSQL.what());
    }

    delete res;
    delete stmt;
    delete conn;
}

正确配置步骤 #

1. 匹配版本与平台 #

确保MySQL Connector C++版本与Visual Studio 2022的平台（x86/x64）、运行时库（MD/MDd）完全一致。CLR项目不推荐使用静态链接版本，优先选择动态链接版本。

2. 基础路径配置 #

• C/C++ → 常规 → 附加包含目录：添加MySQL Connector C++的include文件夹路径，例如C:\Program Files\MySQL\Connector C++ 8.0\include
• 链接器 → 常规 → 附加库目录：添加对应平台的lib文件夹路径，例如C:\Program Files\MySQL\Connector C++ 8.0\lib\x64

3. 动态链接配置 #

• 链接器 → 输入 → 附加依赖项：Debug模式添加mysqlcppconn-debug.lib，Release模式添加mysqlcppconn.lib
• 预处理器定义：不要添加STATIC_CONCPP，动态链接无需该宏

4. 运行时依赖处理 #

编译完成后，将对应版本的动态链接库文件（Debug版mysqlcppconn-debug.dll，Release版mysqlcppconn.dll）复制到CLR项目的输出目录（如x64\Debug），或者将DLL所在路径加入系统PATH环境变量。

5. 代码优化与异常排查 #

• 可在连接字符串中显式指定字符集，避免编码问题：

  const std::string server = "tcp://127.0.0.1:3306?characterEncoding=utf8";
  

• 检查MySQL服务绑定地址：确保my.ini中bind-address设置为0.0.0.0而非仅localhost
• 验证账号权限：通过SELECT user, host FROM mysql.user;确认root账号允许从127.0.0.1登录
• 放行端口：关闭本地防火墙或添加3306端口的入站规则

内容的提问来源于stack exchange，提问作者Stas Furmavnin