C++ 本身不内置数据库连接能力，必须依赖外部库；ODBC 是通用接口，MySQL Connector/C++ 是 MySQL 官方专用驱动——选哪个取决于是否需要跨数据库兼容性。
直接说结论：C++ 本身不内置数据库连接能力，必须依赖外部库；ODBC 是通用接口，MySQL Connector/C++ 是 MySQL 官方专用驱动 —— 选哪个，取决于你是否需要跨数据库兼容性，还是只连 MySQL。
ODBC 连接 MySQL 的实际步骤
ODBC 不是 C++ 标准库，而是操作系统级 API（Windows 自带，Linux/macOS 需装 unixODBC + MySQL ODBC Driver）。它通过统一接口屏蔽底层差异，但配置麻烦、错误信息抽象、调试困难。
- 先装 MySQL ODBC 驱动（如
mysql-connector-odbc-8.0.33），并用odbcinst.ini和odbc.ini配置 DSN（Data Source Name） - 在代码中用
SQLAllocHandle、SQLConnect、SQLExecDirect等 C 风格函数操作，没有 RAII，必须手动SQLFreeHandle - 常见报错
[IM002] [Microsoft][ODBC Driver Manager] Data source name not found，基本是 DSN 名写错或驱动没注册 - 执行查询后，字段名需用
SQLColAttribute手动获取，不能直接按列名取值
MySQL Connector/C++ 8.0 的正确链接方式
这是 MySQL 官方 C++ 封装，基于 X DevAPI（推荐）或传统 JDBC 风格 API。X DevAPI 更现代，支持 JSON 文档、异步、连接池；传统 API（sql::Connection）更接近 Java JDBC，文档多但已标记为 deprecated。
- 编译时链接
-lmysqlcppconn8（不是mysqlcppconn，v8 后命名变了） - 头文件路径通常是
#include（X DevAPI）或#include（传统） - 连接字符串格式不同：
mysqlx://user:pass@127.0.0.1:33060/mydb（X DevAPI，默认端口 33060） vstcp://127.0.0.1:3306（传统） - 别漏掉运行时依赖：
libmysqlcppconn8.so和底层libmysqlclient版本要匹配，否则报undefined symbol: _ZNK3sql13SQLStringHashclERKS0_类似错误
参数与异常处理的关键细节
两种方式都容易忽略连接参数和异常粒度。MySQL Connector/C++ 默认不抛异常，得手动调用 driver->setLoginTimeout(5) 或在连接 URL 加 ?connect-timeout=5；ODBC 则靠 SQLSetConnectAttr 设置 SQL_ATTR_LOGIN_TIMEOUT。
立即学习“C++免费学习笔记（深入）”；
- 密码含特殊字符（如
@、/）必须 URL 编码，否则mysqlx://u:p@w@host/db会解析失败 - ODBC 中
SQLExecute成功只代表语句提交成功，不表示影响行数 —— 要用SQLRowCount拿结果 - Connector/C++ 的
Session::sql("INSERT...").execute()返回SqlResult，但getAffectedItemsCount()在无匹配时返回 0，不是异常 - 所有连接对象都不应跨线程共享；若需并发，用连接池（Connector/C++ 8.0+ 提供
Pool类，但生产环境建议用第三方池如cpplinq配合std::shared_ptr管理）
最常被跳过的一步：确认 MySQL 服务开启远程访问（bind-address = 0.0.0.0）、用户授权（CREATE USER 'u'@'%' IDENTIFIED BY 'p'; GRANT ALL ON db.* TO 'u'@'%';），否则连本地 IP 都拒绝，还误以为是代码问题。
