必须安装匹配位数的MySQL ODBC驱动并在连接字符串中精确使用驱动全名；需正确初始化环境、严格按顺序分配/释放句柄；查询结果须用SQLBindCol+SQLFetch手动绑定并检查返回值。
ODBC 连接 MySQL 前必须装对驱动
直接调 SQLDriverConnect 却报错 [IM002] [Microsoft][ODBC Driver Manager] Data source name not found and no default driver specified？八成是没装 MySQL ODBC 驱动，或者装了 32/64 位不匹配。Windows 上必须去 MySQL 官网下 MySQL Connector/ODBC（比如 8.0.33 版），注意和你的 C++ 程序位数一致：VS 默认生成 64 位就装 x64 驱动，否则 SQLAllocHandle 都可能返回失败。
装完在「ODBC 数据源管理器」里确认驱动出现在「驱动程序」页签，名称通常是 MySQL ODBC 8.0 Unicode Driver 或 MySQL ODBC 8.0 ANSI Driver ——代码里要用这个**完整名称**，不能简写。
连接字符串写法决定能否连上
ODBC 连接字符串不是拼 SQL URL，得按 ODBC 规范组织键值对。常见错误是漏掉 DRIVER=、用错等号、或把空格塞进值里导致截断。正确示例：
DRIVER={MySQL ODBC 8.0 Unicode Driver};SERVER=localhost;DATABASE=testdb;UID=root;PWD=123456;PORT=3306;
关键点：
立即学习“C++免费学习笔记（深入）”；
Windows 桌面自动化技能，支持鼠标控制（移动/点击/拖拽/滚轮/截图）、键盘输入（文字输入/按键/组合键）、窗口管理（查找/聚焦/最大化/最小化/关闭/移动）、截图并发送文件。提供两种截图方式：Python pyautogui 截图（集成在自动化流程中）和 PowerShell + .NET 零依赖截图（支持区域截图和多显示器）。当用户需要自动化 Windows 桌面操作、控制鼠标键盘、管理窗口、执行 GUI 自动化任务、截图发送文件时使用。
-
DRIVER={}中的名称必须和 ODBC 管理器里显示的**完全一致**，包括空格和版本号 - 所有键名（如
SERVER、UID）都是大写，且不支持小写别名 - 密码含特殊字符（如
;、{）必须 URL 编码，但更稳妥的做法是改用SQLConnect分字段传参 - 如果 MySQL 开启了 SSL，需追加
SSL_CA=path\to\ca.pem;SSL_CERT=path\to\client-cert.pem;SSL_KEY=path\to\client-key.pem;
SQLAllocHandle 失败大概率是环境没初始化
调 SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv) 返回 SQL_ERROR？不是代码写错了，而是漏了环境初始化。ODBC 要求先设版本，否则句柄分配失败：
SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv); SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (void*)SQL_OV_ODBC3, 0); // 必须这行！
另外两个易错点：
-
henv、hdbc、hstmt必须逐级申请，不能跳过hdbc直接用henv执行查询 - 释放顺序必须严格倒序：
SQLFreeHandle(SQL_HANDLE_STMT, hstmt)→SQLFreeHandle(SQL_HANDLE_DBC, hdbc)→SQLFreeHandle(SQL_HANDLE_ENV, henv)，否则后续连接可能卡死 - Windows 上若用多线程访问同一连接，必须在
SQLSetConnectAttr(hdbc, SQL_ATTR_ODBC_CURSORS, SQL_CURSORS_EXTENDED, 0)启用游标共享，否则并发查询会崩
执行查询后取数据得自己挪内存
ODBC 不像现代 ORM 那样自动映射对象。SQLExecDirect 只发命令，真正读数据靠 SQLBindCol + SQLFetch。最常踩的坑是：
- 绑定列时类型写错：
SQL_C_CHAR对应 C 字符串，SQL_C_LONG对应long，但 MySQL 的INT在 64 位 Windows 下建议用SQL_C_SBIGINT避免截断 - 字符列长度没预留结束符：
char name[256]绑定时要写sizeof(name)-1，否则SQLFetch可能不写\0导致printf崩溃 - 没检查
SQLFetch返回值：SQL_SUCCESS表示一行 OK，SQL_NO_DATA是结束，SQL_ERROR得立刻查SQLGetDiagRec拿具体错误
简单查一行两列的示意：
SQLCHAR name[256];
SQLLEN name_len;
SQLINTEGER age;
SQLLEN age_len;
SQLBindCol(hstmt, 1, SQL_C_CHAR, name, sizeof(name)-1, &name_len);
SQLBindCol(hstmt, 2, SQL_C_LONG, &age, 0, &age_len);
if (SQLFetch(hstmt) == SQL_SUCCESS) {
printf("Name: %s, Age: %d\n", name, age);
}
ODBC 的麻烦不在语法，而在每一步都依赖外部状态：驱动版本、连接字符串格式、句柄生命周期、内存绑定细节——少对一环，错误信息就只甩个泛泛的 SQL_ERROR，得手动一层层 SQLGetDiagRec 排查。 
