简介：这份资源面向具备一定C++基础的Windows桌面开发者，提供在MFC框架下通过ODBC接口访问MySQL数据库的完整示例工程，帮助解决传统桌面应用如何连接并操作关系型数据库的实际问题。压缩包共117个文件，约181KB，以49个c源文件和46个h头文件为核心，辅以dsp、dsw、mak等工程构建文件及rc资源脚本，构成可直接编译的VC项目结构。内容围绕CDaoDatabase与CDaoRecordset类展开，涵盖ODBC数据源配置、连接建立、记录集创建、SQL查询执行以及数据增删改查等关键环节，并涉及MySQL Connector/ODBC驱动的安装与DSN设置。已有145人学习下载，适合希望掌握MFC数据库编程、理解ODBC访问机制的开发者参考，可作为课程设计或小型管理系统的起步模板，同时提醒注意异常处理、预编译语句防注入与连接及时释放等实践要点。
1. 拆开一个 MFC 连 MySQL 的老包：它到底能跑通什么
前阵子有个做工业上位机的朋友丢给我一个压缩包，文件名是MySQL.rar_MFC MYSQL_MFC Mysql_MySQL MFC c_MySql ODBC_odbc mys，一看就是那种从老论坛、老网盘里翻出来的命名风格。他问得很直接：这东西现在还能不能用，能不能让我的 MFC 程序连上 MySQL。我解压看了一眼，里面是myodbc.001、mysys.001、strings.001、lib.001、dbug.c、_ctype.c、libmysql.c、results.c、info.c、catalog.c这一堆文件，外加一个下载说明.txt和一个名字像随机串的qddown_vc92842352525。
这不是一个现代意义上的完整工程，更像是一份「MFC + ODBC + MySQL 客户端库」的混合素材包。它的价值不在于开箱即用，而在于你能从里面看到早期 Windows 桌面程序是怎么通过 ODBC 把 MySQL 接进来的——DSN 怎么配、CDatabase和CRecordset怎么用、连接字符串怎么写、结果集怎么遍历。适合两类人：一是维护老 MFC 项目、必须继续用 ODBC 的从业者；二是想搞明白「ODBC 这层抽象到底干了什么」的开发者。如果你指望双击 exe 就出界面，那大概率会失望，但如果你想拿它当模板改出自己的数据访问层，这份素材是有拆解价值的。
2. 先搞清楚 ODBC 这条链路：MFC 到 MySQL 中间隔了几层
2.1 为什么是 ODBC，而不是直接调 MySQL C API
很多人第一反应是：既然压缩包里有libmysql.c、results.c这些文件，为什么不直接用 MySQL 官方的 C API 去连？答案在于 MFC 的定位。MFC 是一套 Windows 桌面开发类库，它自己封装了一套数据库访问类，早期是 DAO，后来主推 ODBC 方向的CDatabase/CRecordset。这套类不关心你背后是 MySQL、SQL Server 还是 Access，它只认 ODBC 驱动。
链路是这样的：你的 MFC 程序调用CDatabase::Open，MFC 把请求交给 ODBC 驱动管理器，驱动管理器再加载 MySQL Connector/ODBC 驱动，驱动最终和 MySQL 服务器通信。中间多了一层，换来的是换数据库时业务代码基本不动。压缩包里那些dbug.c、_ctype.c、libmysql.c，本质是 MySQL 客户端库的源码片段，属于驱动底层的东西，不是让你直接改的，而是让你理解「驱动不是黑匣子」。
提示：如果你现在的项目还在用
CDaoDatabase，注意那是 DAO 路线，和 ODBC 不是一回事。DAO 依赖 Jet 引擎，连 MySQL 很别扭，真正走 ODBC 的是CDatabase和CRecordset。
2.2 压缩包里各文件的角色，别一上来就乱编译
解压后先别急着点那个qddown_vc92842352525。按经验，这类文件要么是编译产物，要么是改名后的源码，直接运行有风险。先看下载说明.txt，它通常写了构建顺序和依赖。剩下那些.001后缀的文件，常见做法是分卷压缩或者被重命名过的源码文件，需要按说明还原。
| 文件 | 大概率角色 | 处理方式 |
|---|---|---|
下载说明.txt | 构建/运行指南 | 先读，按它走 |
qddown_vc92842352525 | 编译产物或源码 | 先确认类型，别直接双击 |
myodbc.001 | ODBC 驱动相关素材 | 配合驱动安装理解 |
libmysql.c/results.c | MySQL 客户端库源码 | 阅读用，不建议改 |
dbug.c/_ctype.c | 调试与字符处理 | 理解底层行为 |
info.c/catalog.c | 元数据/目录信息处理 | 看它怎么取库表信息 |
这张表不是让你逐个编译，而是让你建立预期：这是一个「素材 + 说明」的组合，不是一键工程。我一般会先把说明读完，再决定哪些文件进 VS 工程，哪些只当参考资料。
2.3 环境准备：驱动、DSN、工程三件事
真正要跑起来，绕不开三件事。第一，装 MySQL Connector/ODBC 驱动，注意 32 位和 64 位要和你编译的 MFC 程序一致，这是最常见的翻车点。第二，在 ODBC 数据源管理器里配 DSN，填服务器地址、端口、数据库名、用户名、密码。第三，在 VS 里建 MFC 工程，把数据库访问代码接进去。
:: 以 64 位驱动为例，查看已安装的 ODBC 驱动 reg query "HKLM\SOFTWARE\ODBC\ODBCINST.INI\ODBC Drivers" :: 查看系统 DSN 列表 reg query "HKLM\SOFTWARE\ODBC\ODBC.INI\ODBC Data Sources"这两条命令的作用是确认驱动和 DSN 是否真的注册成功。参数上，HKLM对应系统级，HKCU对应用户级；如果你配的是用户 DSN，就去HKCU\SOFTWARE\ODBC\ODBC.INI下查。很多人配完 DSN 在程序里连不上，八成是位数不匹配或者 DSN 配到了另一个账户下。
3. 把连接和查询写进 MFC：CDatabase 与 CRecordset 实操
3.1 用 CDatabase 建立连接，连接字符串别写死
MFC 里连 ODBC 数据源，核心就是CDatabase。它有两种打开方式：传 DSN 名，或者传完整连接字符串。我一般推荐连接字符串，因为部署时不用每台机器都去配 DSN，少一层配置就少一类故障。
// MFC 中通过 ODBC 连接 MySQL 的基本写法 CDatabase db; CString connStr; // 方式一：使用 DSN // connStr = _T("DSN=MySqlDsn;UID=root;PWD=your_password;"); // 方式二：使用完整连接字符串，免配 DSN connStr = _T("DRIVER={MySQL ODBC 8.0 Driver};") _T("SERVER=127.0.0.1;PORT=3306;") _T("DATABASE=testdb;UID=root;PWD=your_password;") _T("OPTION=3;"); try { // 第三个参数 FALSE 表示不弹出 ODBC 登录对话框 db.OpenEx(connStr, CDatabase::noOdbcDialog); } catch (CDBException* e) { AfxMessageBox(e->m_strError); e->Delete(); return; }逻辑说明：OpenEx比Open更灵活，第二个参数控制是否弹登录框，noOdbcDialog适合无人值守场景。参数上，DRIVER必须和已安装驱动名完全一致，写错一个字符就报「找不到驱动」；OPTION=3是常见组合，涉及自动重连等行为，具体含义随驱动版本略有差异，建议对照你装的驱动文档确认。try/catch捕获CDBException是必须的，否则连接失败时程序直接崩，连错误信息都看不到。
3.2 用 CRecordset 取数据，注意游标和字段绑定
连接建好之后，查询靠CRecordset。它支持两种模式：快照（snapshot）和动态集（dynaset）。桌面程序里读多写少，快照够用；需要实时反映别人改的数据，就用动态集。
// 定义记录集类，绑定字段 class CUserSet : public CRecordset { public: CUserSet(CDatabase* pdb) : CRecordset(pdb) {} CString m_name; int m_age; virtual void DoFieldExchange(CFieldExchange* pFX) { pFX->SetFieldType(CFieldExchange::outputColumn); RFX_Text(pFX, _T("name"), m_name); RFX_Long(pFX, _T("age"), m_age); } }; // 使用 CUserSet rs(&db); rs.Open(CRecordset::snapshot, _T("SELECT name, age FROM users")); while (!rs.IsEOF()) { // 此时 m_name、m_age 已自动填充 TRACE(_T("%s - %d\n"), rs.m_name, rs.m_age); rs.MoveNext(); } rs.Close();逻辑说明：DoFieldExchange是 MFC 的字段交换机制，RFX_Text、RFX_Long把结果集列和成员变量绑起来，省去手动取值。参数上，Open第一个参数选记录集类型，第二个参数是 SQL 或表名。注意IsEOF()判断要在MoveNext之前，顺序写反会漏掉最后一条或多读一条。字段类型必须和数据库列类型对得上，RFX_Long对应int，字符串用RFX_Text，类型不匹配会抛异常。
3.3 增删改：AddNew、Edit、Update 的正确顺序
写操作是新手最容易踩坑的地方。MFC 的记录集写操作有固定节奏：AddNew之后填字段，再Update；Edit之后改字段，再Update。顺序错了，数据要么没写进去，要么写进去的是旧值。
// 新增一条记录 rs.AddNew(); rs.m_name = _T("张三"); rs.m_age = 28; if (!rs.Update()) { // Update 返回 FALSE 表示失败 AfxMessageBox(_T("新增失败")); } rs.Requery(); // 重新查询，让记录集反映最新数据 // 修改当前记录 rs.Edit(); rs.m_age = 30; rs.Update();逻辑说明：AddNew只是把记录集置为「新增态」，真正落库靠Update。Update返回布尔值，必须判断。Requery的作用是刷新记录集，否则你新增完再遍历可能看不到新数据。参数上没有额外配置，但要注意：如果表有自增主键，新增时不要手动给主键赋值，交给数据库处理。
4. 避坑排查：这几类问题我几乎每次都能遇到
4.1 现象：提示「未找到数据源名称且未指定默认驱动程序」
原因：连接字符串里的DSN名和 ODBC 管理器里配的不一致，或者你用的是用户 DSN，但程序以另一个账户运行。解决：改用完整连接字符串，把DRIVER、SERVER、DATABASE全写进去，绕开 DSN。如果必须用 DSN，确认位数一致，并在同一账户下配置。
4.2 现象：程序在 32 位下能连，64 位下报驱动找不到
原因：MySQL Connector/ODBC 的 32 位和 64 位是两套独立安装，ODBC 管理器也分两个。解决：确认你的 MFC 工程目标平台，装对应位数的驱动。在 64 位系统上，C:\Windows\System32\odbcad32.exe是 64 位管理器，C:\Windows\SysWOW64\odbcad32.exe是 32 位管理器，别搞混。
4.3 现象：中文写入数据库变成乱码
原因：连接字符集和数据库字符集不一致。解决：在连接字符串里加charset=utf8mb4，并确认数据库表和列的字符集也是utf8mb4。MFC 这边注意CString到窄字符的转换，必要时用CT2A并指定编码。
4.4 现象：CRecordset::Open抛异常，提示字段类型不匹配
原因：DoFieldExchange里绑定的类型和实际列类型对不上，比如数据库是BIGINT，你用RFX_Long接。解决：核对列类型，BIGINT用RFX_LongLong，DECIMAL用RFX_Text或专门的数值交换函数。改完记得重新编译，RFX 是编译期绑定。
4.5 现象：程序退出时崩溃，或者连接没释放
原因：CDatabase和CRecordset对象生命周期没管好，记录集没Close就析构了数据库对象。解决：先rs.Close()，再db.Close()，顺序不能反。如果CDatabase是成员变量，确保它在记录集之后析构，或者显式关闭。
注意：压缩包里那个
qddown_vc92842352525如果真是可执行文件，别在生产机上直接跑。老资源包里的二进制来源不明，先在虚拟机里确认行为。
5. 从能跑到好用：连接池、异常兜底和一个验证习惯
把基本流程跑通只是第一步。真正放到项目里，还得解决两个问题：频繁连接的开销，以及异常情况下的资源回收。
连接池这块，ODBC 本身支持驱动级连接池，在 ODBC 管理器里可以开启。开启后，db.Close()并不是真的断开，而是把连接还给池子，下次Open复用。配置路径在 ODBC 数据源管理器的「连接池」选项卡里，把「启用连接池」勾上，设置超时时间。对于桌面程序，如果只是偶尔查一次，池化收益不大；如果是高频读写，开启后能明显减少握手开销。
// 一个更稳的封装思路：RAII 管理连接生命周期 class CDbGuard { public: CDbGuard(CDatabase& db, const CString& connStr) : m_db(db) { m_db.OpenEx(connStr, CDatabase::noOdbcDialog); } ~CDbGuard() { if (m_db.IsOpen()) m_db.Close(); } private: CDatabase& m_db; }; // 使用：离开作用域自动关闭，异常也不怕 { CDbGuard guard(db, connStr); CUserSet rs(&db); rs.Open(CRecordset::snapshot, _T("SELECT name, age FROM users")); // ... 操作 rs.Close(); }逻辑说明：RAII 的核心是把资源释放绑到对象析构上，即使中间抛异常，栈展开时析构函数照样执行，连接不会泄漏。参数上没什么可调的，关键是CDbGuard的析构里判断IsOpen，避免重复关闭。这个模式我在好几个老项目里都用过，比手动try/catch/finally清爽得多。
验证方法上，我有个习惯：每次改完数据库访问代码，先跑一个最小验证——连上、查一条、写一条、断开，四步都过再往下做业务。具体做法是写个临时函数，用SELECT 1确认连接，用一张测试表确认读写，最后确认进程退出后没有残留连接（可以在 MySQL 里SHOW PROCESSLIST看）。这个习惯帮我挡掉过好几次「本地能跑、部署就挂」的问题，因为部署环境的驱动版本、字符集、账户权限往往和本地不一样。
从那以后我每次拿到这种老资源包，都强制先走一遍「读说明、验驱动、最小连接测试」三步，不跳过任何一步。希望这份拆解能帮到你，少走点我当年走过的弯路。
本文还有配套的精品资源，点击获取
