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风格，需手动管理连接、结果集、内存。

立即学习“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`

							

								
								

									PHP Apache和MySQL 网页开发初步
									
本书全面介绍PHP脚本语言和MySOL数据库这两种目前最流行的开源软件，主要包括PHP和MySQL基本概念、PHP扩展与应用库、日期和时间功能、PHP数据对象扩展、PHP的mysqli扩展、MySQL 5的存储例程、解发器和视图等。本书帮助读者学习PHP编程语言和MySQL数据库服务器的最佳实践，了解如何创建数据库驱动的动态Web应用程序。
								
								下载 
							
						
用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++提升开发效率，是稳妥的学习路径。