MFC是微软推出的用于开发Windows桌面应用的框架，MySQL是常用的开源关系型数据库，二者结合可以实现桌面应用的数据存储、查询、更新等功能。目前主流的连接方式有两种，分别是通过ODBC数据源连接和直接调用MySQL C API连接，开发者可以根据项目需求选择合适的方式。
方式一：通过ODBC连接MySQL
1. 环境准备
首先需要安装MySQL ODBC驱动，根据系统位数选择对应的32位或64位驱动安装包，安装完成后配置ODBC数据源。打开Windows的ODBC数据源管理器，添加MySQL ODBC驱动，填写数据源名称、MySQL服务器地址、端口、用户名、密码和要连接的数据库名称，测试连接通过后保存配置。
2. MFC代码实现
在MFC项目中，需要包含数据库相关的头文件，使用CDatabase和CRecordset类完成数据库操作。以下是连接和查询的示例代码：
#include <afxdb.h> // 包含MFC数据库操作头文件
// 连接MySQL数据库
bool ConnectMySQLByODBC()
{
CDatabase db;
CString strConnect;
// 填写之前配置的ODBC数据源名称，以及MySQL用户名和密码
strConnect.Format(_T("DSN=你的数据源名称;UID=root;PWD=你的密码;"));
try
{
// 打开数据库连接
if (db.OpenEx(strConnect, CDatabase::noOdbcDialog))
{
AfxMessageBox(_T("ODBC连接MySQL成功"));
// 执行查询操作示例
CRecordset rs(&db);
rs.Open(CRecordset::forwardOnly, _T("SELECT * FROM test_table"));
while (!rs.IsEOF())
{
CString strName;
// 读取字段值，假设第一列是name字段
rs.GetFieldValue(_T("name"), strName);
AfxMessageBox(strName);
rs.MoveNext();
}
rs.Close();
db.Close();
return true;
}
else
{
AfxMessageBox(_T("ODBC连接MySQL失败"));
return false;
}
}
catch (CDBException* e)
{
AfxMessageBox(e->m_strError);
e->Delete();
return false;
}
}
方式二：通过MySQL C API连接MySQL
1. 环境准备
需要下载MySQL的C API开发库，将库文件中的include目录添加到MFC项目的附加包含目录，lib目录添加到附加库目录，同时在链接器中添加libmysql.lib依赖。如果是32位项目需要对应32位的库，64位项目对应64位库，否则会出现链接错误。
2. MFC代码实现
直接调用MySQL提供的C API函数完成连接和操作，以下是示例代码：
#include <mysql.h> // 包含MySQL C API头文件
#pragma comment(lib, "libmysql.lib") // 链接MySQL库
// 连接MySQL数据库
bool ConnectMySQLByAPI()
{
MYSQL* mysql = mysql_init(NULL); // 初始化MySQL对象
if (mysql == NULL)
{
AfxMessageBox(_T("MySQL初始化失败"));
return false;
}
// 设置连接参数，依次为对象、服务器地址、用户名、密码、数据库名、端口、Unix socket、客户端标志
if (mysql_real_connect(mysql, "127.0.0.1", "root", "你的密码", "test_db", 3306, NULL, 0) != NULL)
{
AfxMessageBox(_T("C API连接MySQL成功"));
// 执行查询示例
if (mysql_query(mysql, "SELECT * FROM test_table") == 0)
{
MYSQL_RES* result = mysql_store_result(mysql); // 获取查询结果
if (result != NULL)
{
MYSQL_ROW row;
while ((row = mysql_fetch_row(result)) != NULL)
{
CString strValue = row[0]; // 获取第一列的值
AfxMessageBox(strValue);
}
mysql_free_result(result); // 释放结果集
}
}
mysql_close(mysql); // 关闭连接
return true;
}
else
{
CString strError = mysql_error(mysql); // 获取错误信息
AfxMessageBox(strError);
mysql_close(mysql);
return false;
}
}
两种方式的对比
可以通过以下表格了解两种方式的差异，方便选择：
| 对比项 | ODBC方式 | MySQL C API方式 |
|---|---|---|
| 依赖配置 | 需要安装ODBC驱动并配置数据源 | 需要引入MySQL开发库，配置项目依赖 |
| 通用性 | 支持所有兼容ODBC的数据库，通用性强 | 仅支持MySQL数据库，针对性强 |
| 操作便捷性 | MFC封装类操作更简便，适合快速开发 | 需要手动调用API，代码相对繁琐 |
| 性能 | 多一层ODBC封装，性能略低 | 直接调用底层API，性能更高 |
常见问题及解决办法
- 连接时提示驱动未找到：检查ODBC驱动位数是否和系统、项目位数匹配，32位项目需要32位驱动，64位同理。
- 链接错误：检查MySQL库的路径是否正确添加到项目配置中，lib文件是否和项目位数对应。
- 中文乱码：连接成功后执行
mysql_set_character_set(mysql, "gbk")（C API方式）或者在ODBC数据源中设置字符集为gbk，保证和MFC的字符编码一致。 - 连接超时：检查MySQL服务器是否启动，端口是否开放，用户名密码是否正确。
MFCMySQLODBC数据库编程CRecordset修改时间：2026-07-21 23:57:31