简介面向C桌面开发者的MySQL数据库访问实例以MFC为界面框架通过ODBC统一接口连接MySQL适合正在学习数据库编程、准备课程设计或需要快速搭建MFCODBC数据访问模板的开发者参考。资源为RAR压缩包共117个文件主体为C/C源代码.c/.h并配有dsp、dsw、mak等工程配置文件以及txt、readme说明文档整体仅约181KB结构紧凑解压后可按目录直接阅读和编译调试。内容围绕MFC中ODBC编程展开涉及CDaoDatabase/CDaoRecordset的数据库连接与记录集操作、MySQL Connector/ODBC驱动安装、DSN配置以及从初始化ODBC、建立连接、创建记录集、执行SQL、数据编辑更新到关闭连接的标准流程压缩包内的下载说明.txt还会提示构建与运行方法便于快速跑通示例并根据自身需求改造。目前已有145人学习虽然包体不大但作为MFCODBC访问MySQL的起点模板值得课程设计、毕业设计和日常开发练习时直接参考。1. MFC 接 MySQL绕不开 ODBC 的老配方维护一个跑了好几年的 MFC 桌面程序突然要把后端从 SQL Server 换成 MySQL最头疼的不是 SQL 语法而是数据访问层怎么改才不伤筋动骨。直接换 MySQL C API连接句柄、结果集、错误码全要自己管上 Connector/C老工程又得为运行时库折腾半天。最终能落地的往往还是 Windows 系统自带的 ODBC 接口——MFC 里的 CDatabase 和 CRecordset 本来就封装好了这层。这份资源走的正是这条路里面既有 MySQL ODBC 驱动MyODBC的源码分卷和核心源文件也有一个在 MFC 中通过 ODBC 读写 MySQL 的成例下载说明、可执行文件都附在包里。它适合两类人一类是维护老 MFC 工程、希望数据访问层尽量少改动的开发者另一类是拿 VC/MFC 做课程设计、需要连 MySQL 的学生。下面按我拆包的习惯从选型原理到代码落地再到易翻车的细节一步步过一遍。2. 选型依据为什么最终绕回 ODBC 而不是 C API2.1 三条技术路线的适用边界MFC 程序访问 MySQL常见路线有三条MySQL 官方 C API、Connector/C 和 ODBC 接口。资源包里的 libmysql.c 就是 C API 客户端库的主体文件可以把它理解成 MySQL 给 C 语言程序准备的原始武器。用 C API 写代码是这样的节奏mysql_init 初始化句柄mysql_real_connect 建连mysql_store_result 拿结果集mysql_fetch_row 逐行取数最后 mysql_free_result 释放。每一步都是裸接口和 MFC 的 CString、TRACE、异常处理完全是两个路子。老工程要是整层换到这套数据访问层的每个函数几乎都要重写工期和风险都不可控。Connector/C 是官方面向现代 C 的接口类型安全、支持 STL新工程值得考虑。但它在 Windows 上依赖较新的 VC 运行库对 VS2008 甚至更早年代遗留下来的 MFC 工程不太友好经常在链接阶段冒出运行时库冲突。工程只要还在用老编译器引入它就等于先解决一堆环境问题很多团队评估完就放弃了。ODBC 是三条路里改动面最小的。它是 Windows 系统级的数据访问标准MFC 从 VC6 时代就内置了 afxdb.h 这一整套封装CDatabase 管连接、CRecordset 管结果集连错误处理都是现成的 CDBException。界面层、业务层完全可以不动只需要把连接层从原来的 SQL Server ODBC 换成 MySQL 的 ODBC 驱动。三者的取舍我一般用下面这张表来定路线封装层次老工程改造量适合场景C API裸接口全手工管理句柄和结果集数据访问层全面重写新写的纯 C 程序无界面Connector/C类型安全的 C 封装中等受编译器/运行库版本制约新工程、现代编译器ODBC系统级标准MFC 内置封装极小只换驱动和连接参数老 MFC 工程、需要快速落地2.2 ODBC 调用链CDatabase 怎么穿过驱动到达 MySQL一次 db.Open 调用实际经过四层。最上层是 MFC 的 CDatabase它把 SQL 语句和连接参数打包成 ODBC API 调用然后交给 Windows 的 ODBC 驱动管理器 odbc32.dll由它按数据源名里登记的驱动名定位到具体的驱动实现再往下是 MySQL 的 Connector/ODBC 驱动负责把 ODBC 标准调用翻译成 MySQL 的网络协议发给 mysqld最后服务器把结果集沿着原路返回CRecordset 拿到的是一个已经按行、按列组织好的结果。这个链条里任何一层版本不对、位数不对表现都是连接失败但错误信息往往让人摸不着头脑——这就是 ODBC 最典型的玄学时刻。DSN 是链路里承上启下的关键。数据源名就是一段配置的别名把驱动名、服务器地址、端口、数据库名、用户名、密码都替你存好了程序只需要传一个名字。但 DSN 在客户机上要预先配置部署时多一道手续。更省事的是无 DSN 连接串把配置直接内联到连接字符串里代码里这样写CDatabase db; BOOL bOK db.Open(NULL, FALSE, FALSE, _T(ODBC;DriverMySQL ODBC 8.0 Unicode Driver;) _T(Server127.0.0.1;Port3306;Databasetestdb;) _T(Userroot;Password123456;Option3;));db.Open 的四个参数第一个是 DSN 名传 NULL 表示走连接串第二个参数表示是否独占打开ODBC 下基本无效按惯例传 FALSE第三个参数表示是否只读传 FALSE 才能执行写操作第四个就是完整连接字符串。串里 Driver 必须和 ODBC 管理器中显示的驱动名一字不差Server 和 Port 指向 MySQL 服务地址和端口Database 指定默认库User/Password 对应登录账号Option3 是给驱动管理器的一组标志位掩码教程里最常见的就是 3。这个写法是 ODBC 场景下最实用的部署方式资源里实例程序的下载说明如果让你先配 DSN我建议你优先改成这种内联形式后面第六章会细说为什么。3. 环境准备拆开源码分卷把驱动和 MFC 实例装到位3.1 资源包里那批源码文件MyODBC 驱动在说什么压缩包里除了 MFC 实例和下载说明还列着一串看着眼生的文件myodbc.001、mysys.001、strings.001、lib.001以及 dbug.c、_ctype.c、libmysql.c、results.c、info.c、catalog.c。这些是 MySQL ODBC 驱动旧称 MyODBC源码的一部分。001 结尾的是分卷压缩的分卷文件当年下载站限制单文件大小所以源码被拆成多卷用 7-Zip 打开第一卷就能把完整源码合并解出来。剩下的 .c 文件按模块功能可以归成下面这张表文件在 MyODBC 驱动里承担的角色libmysql.cMySQL C API 客户端库主体驱动与服务器通信的底层通道results.c结果集处理把服务器返回的行数据整理成 ODBC 能枚举的记录catalog.c元数据查询支撑 SQLTables、SQLColumns 这类取库表结构的调用info.c驱动属性与能力上报对应 ODBC 的 SQLGetInfo 接口dbug.cMySQL 自带的 DBUG 调试库跟踪函数调用排错时用_ctype.c字符集分类表实现乱码问题排查到深处时会碰到mysys.001、strings.001、lib.001系统抽象层、字符串工具、基础库的分卷压缩包这些源码文件有两个层面的用处。绝大多数情况下你不需要动它们官方编译好的 Connector/ODBC 驱动拿过来装就行只有当驱动装不上、或者你想搞清楚某个行为比如连接字符集到底走的哪条路径时才需要回头翻源码。对我来说results.c 和 catalog.c 是理解 ODBC 驱动黑匣子最好的入口——后面第六章我会具体说怎么用。3.2 驱动安装与 DSN 两步走第一步是装驱动。去 MySQL 官方下载 Connector/ODBC版本选 8.x 或 5.3 都行关键是位数必须和 MFC 程序的编译目标一致程序是 x86 就用 32 位驱动程序是 x64 就用 64 位驱动。这一步我见过太多翻车现场32 位程序配上 64 位驱动管理器和代码里怎么都找不到数据源。装完建议先在命令行确认 MySQL 服务本身通不通mysql -h 127.0.0.1 -P 3306 -u root -p -e SELECT VERSION();这条命令能返回 MySQL 版本号说明 TCP 服务和账号密码没问题。注意它只验证了 MySQL 协议层ODBC 那一层是否通还要在驱动管理器里验。第二步是配置 DSN。运行 odbcad32.exe 时有个隐蔽的坑64 位 Windows 上这个命令默认打开的是 64 位管理器而 32 位程序用的是另一套 32 位管理器路径在 C:\Windows\SysWOW64\odbcad32.exe两套管理器的 DSN 互不相通。在正确的管理器里点添加驱动选择 MySQL ODBC 8.0 Unicode Driver填上服务器、端口、数据库、用户名和密码点 Test 测试。这一步通过了DSN 就算立住MFC 实例里用 CDatabase 打开数据源名就能连上。如果不想在每台客户机上都配一遍 DSN就用上一章的连接串写法把参数写进配置文件让程序启动时自己拼——这是我现在所有项目里的默认方案。4. MFC 代码落地连接、查询、增删改的最小完整集4.1 工程改造最小步骤头文件、链接库、字符集在 MFC 工程里启用 ODBC不需要引入任何第三方包系统自带。改动只有三处预编译头里包含 afxdb.h这是 MFC ODBC 数据库类的头文件确认链接了 odbc32.libVS 较新的 MFC 工程默认带老工程要在链接器的附加依赖项里手动补上工程字符集统一用 Unicode配合 Connector/ODBC 的 Unicode 版驱动。代码如下// stdafx.h 或预编译头末尾追加 #include afxdb.h // CDatabase、CRecordset、CDBException #pragma comment(lib, odbc32.lib) // ODBC 驱动管理器导入库第一行是 MFC ODBC 编程的主头文件前面写的 CDatabase 在这里声明第二行直接把 odbc32.lib 链进来省得在工程属性里翻菜单。字符集设置在工程属性 → 常规 → 字符集选使用 Unicode 字符集。这一步要和驱动联动程序是 Unicode 版驱动就要选名字里带 Unicode 的那个。程序还是 ANSI 版就接着用 ANSI 驱动也行但中文场景下强烈建议往 Unicode 迁否则乱码问题会一直缠着你。4.2 查询CDatabase 建连CRecordset 走完第一条 SELECT准备工作做完写一个最小的查询流程。假设 testdb 库里有张 users 表字段是 id、name、create_time。下面的代码放在按钮响应里能直接跑CDatabase db; if (!db.Open(NULL, FALSE, FALSE, _T(ODBC;DriverMySQL ODBC 8.0 Unicode Driver;) _T(Server127.0.0.1;Databasetestdb;) _T(Userroot;Password123456;Option3;))) { AfxMessageBox(_T(数据库连接失败)); return; } CRecordset rs(db); rs.Open(CRecordset::snapshot, _T(SELECT id, name, create_time FROM users)); while (!rs.IsEOF()) { CDBVariant varId, varName; rs.GetFieldValue(_T(id), varId); rs.GetFieldValue(_T(name), varName); TRACE(_T(id%d, name%s\n), varId.m_lVal, varName.m_pchValue); rs.MoveNext(); } rs.Close(); db.Close();db.Open 第一个参数传 NULL 就是走无 DSN 连接串CRecordset 构造时传入 db 的地址把它和连接绑定Open 的第二参数 snapshot 表示静态快照打开时一次性拉回结果集适合数据量小、对实时性不敏感的场景。循环体里 GetFieldValue 按字段名取值存进 CDBVariant——它是 MFC 封装的变体类型整型结果从 m_lVal 取字符串从 m_pchValue 取。MoveNext 前进一行IsEOF 判断是否到末尾。关闭顺序要记牢先关记录集再关连接和打开顺序相反。想感知其他会话的实时更新把 snapshot 换成 dynaset但 MySQL 驱动下 dynaset 对环境配置要求高一些没特殊需求时 snapshot 最稳。4.3 写入与事务ExecuteSQL 和事务边界查询用记录集增删改走 CDatabase::ExecuteSQL它不返回结果集专门执行 INSERT、UPDATE、DELETE 和 DDL。事务处理我习惯这样组织db.ExecuteSQL(_T(INSERT INTO users(name) VALUES(测试))); db.BeginTrans(); try { db.ExecuteSQL(_T(UPDATE users SET name张三 WHERE id1)); db.ExecuteSQL(_T(DELETE FROM users WHERE id99)); db.CommitTrans(); } catch (CDBException* e) { db.Rollback(); AfxMessageBox(e-m_strError); e-Delete(); }第一行是单条插入不涉及事务。后面 BeginTrans 开启一个事务两条写操作都成功才 CommitTrans任一条抛 CDBException 就回滚。抓到的异常对象记得 DeleteMFC 的异常机制里它是堆上分配的不释放就是内存泄漏——这正好对得上 MFC 内存泄漏检测里最常见的告警来源。事务有个硬前提MySQL 表必须用 InnoDB 引擎MyISAM 不支持事务BeginTrans 调用看着成功实际更新照常直接落盘回滚完全无效。建表时确认 ENGINEInnoDB。另外ExecuteSQL 里拼 SQL 字符串时参数如果来自界面输入必须转义或改用 CRecordset::BindParameter 做参数绑定我一般在业务入口做严格校验双保险。5. 避坑记录MFC 连 MySQL 的五个常见翻车点5.1 高频翻车点现象、原因、解决先把我踩过和帮别人排查过的坑集中列一遍每条按现象、原因、解决三个维度说透。第一个程序报没有找到数据源DSN 下拉列表里看不到 MySQL 项。现象是 db.Open 直接抛 CDBException错误文本类似未发现数据源名称并且未指定默认驱动程序。原因是位数错位32 位 MFC 程序去找了 64 位管理器里的 DSN两套数据源互不相通。解决方法是把驱动和管理器的位数统一32 位程序用 C:\Windows\SysWOW64\odbcad32.exe 重新配置 DSN。第二个连接字符串被拒报指定的驱动程序不是 ODBC 驱动管理器中的已安装驱动程序。原因是 Driver 后面名字写错。MySQL 的 ODBC 驱动名在不同版本里不一样5.3 是 MySQL ODBC 5.3 Unicode Driver8.0 是 MySQL ODBC 8.0 Unicode Driver差一个字都不认。解决方法是去 ODBC 管理器的驱动程序选项卡里看准确名称原样复制进代码别手敲。第三个中文写进库是好的读出来全是问号或繁体乱码。这几乎是 Unicode 乱码的经典翻车现场。原因是驱动选了 ANSI 版或库表字符集和程序字符集没对齐。解决方法是一套组合拳程序用 Unicode 字符集驱动用名字带 Unicode 的版本库和表全部用 utf8mb4连接串里再显式加 CHARSETutf8mb4让驱动知道连接走什么编码。四者对齐中文基本不会再出问题。第四个按网上资料写的 CDaoDatabase 能编译但打开 MySQL 时报不能打开数据库。这里有个特别坑人的知识点MFC 有两个长得像的类CDaoDatabase 属于 DAO 接口面向微软 Access/JetMySQL 没有 DAO 驱动MFC 里真正走 ODBC 的类是 CDatabase头文件是 afxdb.h 而不是 afxdao.h。看到资料写 CDaoDatabase 连 MySQL直接判定是拼写误导换成 CDatabase 就好。第五个查询几十万行的表界面卡死甚至报Lost connection to MySQL server during query。原因是 snapshot 模式把整表结果一次性拉到客户端加上驱动默认查询超时偏短网络稍慢就断。解决方法是结果集必带 WHERE 条件或 LIMIT 分页优先用 dynaset 或改走存储过程网络环境不稳定时在连接串里把超时参数调大。发布到客户机后连不上也先按这条思路排查八成是目标机没装对应位数驱动。5.2 一套从驱动管理器到最小复现的排查流程遇到连接问题我一般不直接在 MFC 界面里反复试而是按层排查。第一层命令行跑 mysql 客户端验证服务本身和账号密码第二层在 ODBC 管理器的 DSN 配置界面点 Test验证驱动和数据源第三层写一个最小的按钮响应只做 db.Open 加 SELECT 1排除业务 SQL 干扰第四层再放真实 SQL。每一层失败错误信息都比上一层更具体。ODBC 的经典错误码值得记几个。IM002 是数据源未找到多半是 DSN 位数或名字问题08S01 是通信链路失败先查服务器端口和防火墙HY000 是通用错误跟上的一条代码里就有我们要的进程间通信信息。拿到错误码连同驱动版本、程序位数一起对照排查基本不用求助论坛也能定位。6. 把资源用透三条进阶路径和一个验证习惯这份资源除了能帮你把 MFC 连 MySQL 跑通还有几样东西值得继续挖。第一把 DSN 方案彻底改成无 DSN 连接串并塞进配置文件。连接串放到 INI 或注册表里程序启动时读出来拼好传给 CDatabase::Open。客户机上只要装驱动不用逐个配置 DSN。几台机器的项目感受不深几十台机器时这个改动能把现场维护时间砍掉一大截。连接串里额外附上 CHARSETutf8mb4 和超时参数一次配置到处省心。第二从资源里的驱动源码学习 ODBC 的行为。catalog.c 对应 SQLTables、SQLColumns 这类元数据查询你写数据库浏览器、字段枚举工具时能猜到驱动返回什么格式results.c 讲结果集怎么被一行行取走可以解释为什么 GetFieldValue 在某种写法下特别慢_ctype.c 里能看到字符集分类表的组织方式乱码问题深挖时会用到这层知识。不需要通读按需翻对应文件就行。第三MFC 界面的数据绑定也值得做完。CRecordset 配上 CRecordView表单控件能自动跟着记录集走增删改按钮只需要调用 Edit、AddNew、Update。这套机制和 ODBC 配合成熟适合内网管理类工具比手写 ListCtrl 加数据搬运省一半代码量。最后说一个我从那次大结果集卡死之后养成的习惯每次改连接字符串、驱动版本、字符集这三项中的任何一项都会先用一个只有 Open 加 SELECT 1 的最小程序验证再放进完整界面流程。这个习惯看着笨但能把你从 ODBC 一类的玄学错误里彻底解放出来。希望帮到你。本文还有配套的精品资源点击获取