用mysqlclient连远程mysql需装libmysqlclient-dev或mysql-devel，编译加-lmysqlclient和-pthread；host勿填localhost，显式指定port；用户须有远程权限并开放防火墙；连接失败先telnet再查mysql_errno；生产环境必须启用ssl。
用 mysqlclient 连远程 MySQL，得先装对库
C++ 本身不带数据库驱动，必须靠第三方库。最常用、最稳的是 mysqlclient（即 libmysqlclient），不是 mysqlcppconn（MySQL Connector/C++），后者维护松散、ABI 不稳定、新版常连不上 8.0+ 服务端。
- 确保系统已安装
libmysqlclient-dev（Ubuntu/Debian）或mysql-devel（CentOS/RHEL） - 编译时加
-lmysqlclient，别漏了-pthread（MySQL C API 内部依赖线程） - 如果用 CMake，写
find_package(MySQL REQUIRED)比硬写路径更可靠，避免头文件找不到或链接到旧版
连接字符串里 host 和 port 别写错
远程连接失败，八成是网络层或认证配置问题，不是代码写错。先确认：
-
host填 IP 或域名，别填localhost（它会走 socket 而非 TCP） - 显式指定
port：MySQL 默认是 3306，但云服务（如阿里云 RDS、AWS RDS）可能改过，务必查控制台 - 用户必须有远程权限：
CREATE USER 'user'@'%' IDENTIFIED BY 'pwd'; GRANT ALL ON db.* TO 'user'@'%'; FLUSH PRIVILEGES; - 防火墙和安全组要放行对应端口，本地
telnet ip 3306能通才算网络可达
mysql_real_connect 返回 NULL？立刻查 mysql_errno
C API 的错误不抛异常，全靠返回值 + 错误码。每次 mysql_real_connect() 后必须检查：
MYSQL *conn = mysql_init(nullptr);
if (!mysql_real_connect(conn, "10.0.2.5", "user", "pwd", "testdb", 3306, nullptr, 0)) {
fprintf(stderr, "Connect failed: %s (errno %d)\n", mysql_error(conn), mysql_errno(conn));
mysql_close(conn);
return -1;
}
常见 mysql_errno 值：
-
1045：用户名或密码错（注意：远程用户不能用localhost作为 host 创建） -
1130：Host 'x.x.x.x' is not allowed to connect（权限没开或 host 匹配不上） -
2003：Can't connect to MySQL server（网络不通或 mysqld 没监听外网）
SSL 连接不是可选项，而是生产环境强制项
明文传账号密码等于裸奔。MySQL 8.0+ 默认要求 SSL，即使服务端没配，客户端也得显式关掉（仅限测试）：
- 连接前调用
mysql_options(conn, MYSQL_OPT_SSL_MODE, &ssl_mode);，其中ssl_mode = SSL_MODE_DISABLED - 生产环境应设为
SSL_MODE_REQUIRED，并用mysql_options(conn, MYSQL_OPT_SSL_CA, "/path/to/ca.pem");加载 CA 证书 - 注意：
mysql_real_connect()的第 7 个参数（unix_socket）传nullptr，第 8 个（client_flag）建议加CLIENT_SSL标志位
远程连接真正卡住的地方，往往不在 C++ 代码本身，而在 MySQL 服务端的 bind-address、skip-networking、require_secure_transport 这些配置项，以及中间防火墙策略——写完代码先 telnet，再看 error code，比反复改 connect 参数有效得多。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
