mysql_init()返回空指针主因是未链接libmysqlclient库或版本不匹配；应检查链接参数、动态库路径及调用mysql_get_client_info()验证加载。
mysql_init() 返回空指针怎么办
直接原因通常是没链接 MySQL 客户端库，或者 libmysqlclient 版本和头文件不匹配。windows 下常见于忘了把 libmysql.dll 放到可执行目录或 PATH；linux 下容易漏掉 -lmysqlclient 链接选项，或用 pkg-config --libs mysqlclient 检查实际链接路径是否指向旧版本。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 编译时确认链接参数含
-lmysqlclient（不是-lmysql） - 运行前用
ldd your_program（Linux）或Dependency Walker（Windows）验证libmysqlclient.so或libmysql.dll是否被正确加载 - 调用
mysql_init(nullptr)前，可先打印mysql_get_client_info()看是否能取到版本号——如果连这个都崩，说明库根本没加载成功
mysql_real_connect() 失败但没报错信息
这是最常踩的坑：函数返回 nullptr，但 mysql_error() 为空，mysql_errno() 是 0。本质是连接过程被中断在 DNS 解析、TCP 握手或认证前阶段，MySQL 客户端库来不及生成错误上下文。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 强制设置超时：
mysql_options(conn, MYSQL_OPT_CONNECT_TIMEOUT, &timeout_sec);（timeout_sec设为 3～5） - 用
mysql_options(conn, MYSQL_OPT_PROTOCOL, &protocol);显式指定protocol = MYSQL_PROTOCOL_TCP，避免 unix socket 路径误判 - 检查目标 IP 和端口能否用
telnet host 3306或nc -zv host 3306直连——很多问题其实出在防火墙或 mysqld 绑定地址（如只监听127.0.0.1）
query 执行后 mysql_store_result() 返回 nullptr
不代表 SQL 错了，而是当前语句类型不产生结果集。比如 INSERT、UPDATE、delete、CREATE 这类语句，应该用 mysql_affected_rows() 或 mysql_insert_id() 获取影响行数或自增 ID，而不是强行取结果集。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 执行前先判断语句类型：若以
"select"开头，才调mysql_store_result()；否则直接查mysql_affected_rows(conn) - 注意
mysql_use_result()和mysql_store_result()的内存模型差异：前者不缓存全部结果，适合大数据量但必须立刻读完；后者把整张结果集拉进内存，适合小查询但后续可反复遍历 - 无论哪种，读完必须调
mysql_free_result()，否则内存泄漏——c++ RAII 封装里最容易漏掉这步
字符编码乱码（中文变问号或 Mojibake）
根源是客户端、连接、数据库三者编码不一致。即使建表用了 utf8mb4，只要连接层没设对，写进去就是乱码，读出来也救不回。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 连接成功后立即执行：
mysql_set_character_set(conn, "utf8mb4");（不是set names utf8mb4） - 确保编译时源文件本身是 UTF-8 编码（尤其 Windows 上 VS 默认 GBK，SQL 字符串字面量可能被误转）
- 如果用预处理语句（
mysql_stmt_prepare），还要额外调mysql_stmt_attr_set(stmt, STMT_ATTR_CHARSET, &cs);设置字段编码
真正麻烦的是历史数据修复——一旦乱码写入，原始字节就丢了，靠转换脚本基本无解。上线前务必在测试环境跑一遍含中文的完整写入+查询链路。