欢迎来到雄杰鑫电商资讯网
技术教程

C++如何连接MySQL数据库？C++数据库编程实例教程【项目实战】

冰火之心 次阅读
C++连接MySQL推荐初学者用原生C API（轻量稳定），进阶用Connector/C++（面向对象、支持预处理）；需安装对应开发包并验证配置工具；C API需手动管理资源，Connector/C++需注意事务提交与空值处理。

用C++连接MySQL，核心是使用MySQL官方提供的C API（libmysqlclient）或更现代的封装库（如mysqlcppconn，即Connector/C++）。推荐初学者从原生C API入手，轻量、稳定、文档全；进阶项目可考虑Connector/C++（支持面向对象、预处理语句、事务更清晰）。

准备环境：安装MySQL开发包

Windows下下载MySQL Installer，勾选“Developer Components”和“C Connector”；Linux用包管理器安装：

  • Ubuntu/Debian：sudo apt install libmysqlclient-dev libmysqlcppconn-dev
  • CentOS/RHEL：sudo yum install mysql-devel mysql-connector-c++-devel

确保能调用mysql_config --cflags --libs（C API）或mysqlcppconn-config --cflags --libs（Connector/C++）验证路径是否就绪。

用C API连接并查询（简洁可靠）

这是最直接的方式，适合嵌入式或性能敏感场景。注意：C API是C风格，需手动管理连接、结果集、内存。

#include 
#include 

int main() {
MYSQL* conn = mysql_init(nullptr);
if (!conn) {
std::cerr << "Init failed\n";
return -1;
}
// 连接数据库（host, user, passwd, db, port, unix_socket, flag）
if (!mysql_real_connect(conn,
                        "127.0.0.1", "root", "password",
                        "testdb", 3306, nullptr, 0)) {
    std::cerr << "Connect error: " << mysql_error(conn) << "\n";
    mysql_close(conn);
    return -1;
}

// 执行查询
if (mysql_query(conn, "SELECT id, name FROM users LIMIT 3")) {
    std::cerr << "Query error: " << mysql_error(conn) << "\n";
    mysql_close(conn);
    return -1;
}

MYSQL_RES* res = mysql_store_result(conn);
if (res) {
    MYSQL_ROW row;
    while ((row = mysql_fetch_row(res))) {
        std::cout << "ID: " << (row[0] ? row[0] : "NULL")
                  << ", Name: " << (row[1] ? row[1] : "NULL") << "\n";
    }
    mysql_free_result(res);
}

mysql_close(conn);
return 0;
}


编译命令（Linux）：
g++ -o demo demo.cpp `mysql_config --cflags --libs`


用Connector/C++执行带参数的插入（面向对象）


适合需要事务、预处理、异常处理的业务逻辑。它基于C API但封装为C++类，支持prepareStatement。
#include 
#include 
#include 
#include 

int main() {
try {
sql::mysql::MySQL_Driver* driver = sql::mysql::get_mysql_driver_instance();
std::unique_ptr conn(driver->connect("tcp://127.0.0.1:3306", "root", "password"));
conn->setSchema("testdb");
    std::unique_ptr pstmt(
        conn->prepareStatement("INSERT INTO users(name, age) VALUES(?, ?)"));

    pstmt->setString(1, "Alice");
    pstmt->setInt(2, 28);
    pstmt->executeUpdate();

    std::cout << "Insert success.\n";

} catch (sql::SQLException& e) {
    std::cerr << "SQL Error: " << e.what() << "\n";
    return -1;
}
return 0;
}


编译命令：
g++ -o demo demo.cpp `mysqlcppconn-config --cflags --libs`


⚠️ 注意：运行时需确保libmysqlcppconn.so在LD_LIBRARY_PATH中，或已安装到系统库路径。


关键提醒与避坑点


实际项目中容易忽略但影响稳定性的问题：


    

  • 每次mysql_query()后必须检查返回值，不能只靠mysql_error()

    • 

  • C API中字符串字段可能为NULL（即row[i] == nullptr），直接std::string(row[i])会崩溃
    • 

  • Connector/C++默认不开启自动提交，conn->setAutoCommit(false)后记得commit()或rollback()

    • 

  • 连接不要全局单例长期持有——MySQL服务端可能主动断连，建议按需创建+连接池（可用第三方如nanodbc或自建）
    • 



基本上就这些。从C API上手理解底层机制，再过渡到Connector/C++提升开发效率，是稳妥的学习路径。






            
 ai windows linux 数据库 这是 工具 进阶 第三方 能为 word 对象 勾选 ios unix NULL 字符串 服务端 mysql 封装 面向对象 c++ ubuntu 管理器 String debian centos 开发包 再过

相关文章

按ESC键退出。