使用C/C++连接数据库，记录某些常见的错误并提供解决方案。

前言

本人在前段时间在做数据库课程设计，使用VS2019连接MySQL数据库，踩了一些坑，于是我想记录一下这些错误，分享一下解决方案。

一、MySQL数据库的连接

引入MySQL数据库的方法很简单，就是在项目属性中添加include目录和lib目录即可。

如果提示某些动态链接库xxx.dll找不到那么就去MySQLServer安装路径中的bin去找到它，并拷贝一份放到自己exe文件目录下，或者还有种方法就是把这个bin目录放到系统环境变量即可解决。

连接代码展示

#include <stdlib.h>
#include <iostream>
#include <iomanip>
#include <mysql.h>

#define HOST "localhost"
#define USERNAME "root"
#define PASSWORD "12345"
#define DATABASE "university"
// SL类
class SL
{
public:
	SL();
	~SL();
	// 初始化连接
	void init(const char* host, const char* user, const char* passwd, const char* db, unsigned int port, const char* unix_socket,unsigned long clientflag);
private:
	MYSQL* mysql;
	MYSQL_RES* result; // 结果集
};

SL::SL() : result(nullptr)
{
    mysql = mysql_init(nullptr); // 初始化连接
    if (!mysql) fprintf(stderr, "mysql_init() failed\n");
}
SL::~SL()
{
    mysql_close(mysql); // 注意这里使用完数据库后，还需关闭
}

void SL::init(const char* host,const char* user, const char* passwd,const char* db, unsigned int port,const char* unix_socket, unsigned long clientflag)
{
    if (mysql_real_connect(mysql, host, user, passwd, db, port, unix_socket, clientflag))
    {
        std::cout << "连接成功\n";
        mysql_query(mysql, "SET NAMES 'GB2312' "); // 设置字符集
        return;
    }
    // 错误信息
    fprintf(stderr, "连接失败: %s\n", mysql_error(mysql));
    return;
}

int main()
{
	SL sl;
	sl.init(HOST, USERNAME, PASSWORD, DATABASE, 0, nullptr, 0);
	return 0;
}

这里注意要设置合适的字符集，比如 GB2312 ，否则乱码

二、控制台清屏

使用c++的小伙伴，估计还用控制台来执行数据库的操作，这里我给出一个比较好用的函数和一个方法

1. 清屏函数（需要引入windows.h头文件）

// 清屏函数
void clearScreen() {
    COORD topLeft = { 0, 0 };
    HANDLE console = GetStdHandle(STD_OUTPUT_HANDLE);
    CONSOLE_SCREEN_BUFFER_INFO screen;
    DWORD written;

    GetConsoleScreenBufferInfo(console, &screen);
    FillConsoleOutputCharacterA(console, ' ', screen.dwSize.X * screen.dwSize.Y, topLeft, &written);
    FillConsoleOutputAttribute(console, FOREGROUND_GREEN | FOREGROUND_RED | FOREGROUND_BLUE, screen.dwSize.X * screen.dwSize.Y, topLeft, &written);
    SetConsoleCursorPosition(console, topLeft);
}

2. 使用system(“cls”);

system("cls"); // 这种方法虽然能清屏，但不知道为什么它会把的控制台的字符集修改了，也就是显示乱码，推荐使用第一种方法。

三、增删改查通用函数

当需要对数据库中的表进行增删改查操作时，往往需要写对应的操作，这可能就要写四个函数了，这样总是有些麻烦的，这里我写好了一个通用的函数，只需要传入SQL语句以及操作的类型，即可完成增删改查。

代码实现

#include <iomanip>
#define _INSERT_ "插入"
#define _DELETE_ "删除"
#define _UPDATE_ "更新"
#define _QUERY_ "查询"

void SL::Operator(const char*&& OperateSQL, const char* OperateType)
{
    if (mysql_query(mysql, OperateSQL))
    {
        fprintf(stderr, "%s失败！ %s\n", OperateSQL,mysql_error(mysql));
        return;
    }
    else
    {
        std::cout << OperateType << "成功！\n";
    }
    
    if (OperateType != _QUERY_) return;

    result = mysql_store_result(mysql);

    int num_fields = mysql_num_fields(result); // 列数
    // 输出列名
    for (int i = 0; i < num_fields; i++)
    {
        std::cout << std::setw(14) << std::left << mysql_fetch_fields(result)[i].name << " ";
    }
    std::cout << std::endl;
    MYSQL_ROW row;

    while ((row = mysql_fetch_row(result))) // 行
    {
        for (int i = 0; i < num_fields; i++) // 列
        {
            std::cout << std::setw(14) << std::left << (row[i] ? row[i] : "NULL") << "  ";
        }
        std::cout << std::endl;
    }
    while (mysql_next_result(mysql) == 0) // 循环清理多余的结果集
    {
        result = mysql_store_result(mysql);
        if (result != nullptr)
        {
            mysql_free_result(result);
        }
    }
}

使用样例：
std::cout << "请输入需要插入的数据（系ID,系名,系主任）：\n";
std::cin >> insertID >> insertName >> insertTeacher;
std::string insert = "INSERT INTO department (DepartmentID, DepartmentName, DepartmentTeacher) \
                    VALUES ('" + insertID + "','" + insertName + "','" + insertTeacher + "')";

Operator(insert.c_str(), _INSERT_);

四、有几点需要注意的(Commands out of sync; you can’t run this command now)

• 当使用查询时如果result接收了结果集 result = mysql_store_result(mysql);没有使用MySQL提供的APImysql_free_result进行释放之前的结果集，这就必然导致报错，可能第一次查询正确，而第二次就出错了。
• 不过有的同学可能已经使用了mysql_free_result进行释放结果集，可还是报错，报错信息如下 Commands out of sync; you can't run this command now我第一次时也保了这个错，通过网上的描述说是，可能是由于现在处于多线程下对数据库操作，但很明显我们这个简单的数据库课程设计并没用到多线程，所以可能还是其他原因，我发现网上说的最多的是使用mysql_free_result来清空结果集，可我的确是那么做的，如下错误代码代码：

/* 错误代码演示 */
result = mysql_store_result(mysql);
...... // 某些不重要的操作，比如显示数据
// 最后清空结果集
mysql_free_result(mysql);

那么你是否是和我这样写的，恭喜你，你将马上解决你的报错问题。

经过我不断的调试，我发现报错其实就是由于我的result结果集没有清空，到这里是不是有疑惑，”我不是使用了mysql_store_result来清空结果集了吗，难道它不能清空结果集？“，这句话半对，mysql_free_result的确能清空数据集，但只是清空一条，真tm坑爹，这个API，我具体没去查，但我隐隐能猜测出这个每次只能清除一行或一条记录，并不能把此次所有查询到的记录全部清空，注意，这是我猜想，不保证正确，而说到这，聪明的你，懂了如何修改你的代码了吗？

正确代码书写方式

result = mysql_free_result(mysql); 把这个改为以下代码：

	// 当mysql_next_result(mysql)返回为0时，才说明结果集清空了
    while (mysql_next_result(mysql) == 0) // 循环清理多余的结果集
    {
        result = mysql_store_result(mysql);
        if (result != nullptr)
        {
            mysql_free_result(result);
        }
    }

即可完美解决。

五、最后

• 有需要的源码的小伙伴可以通过qq2636427505联系我。

吐槽一下

• 不得不说cpp开发效率的确比不了其他语言，如python、java，而且开发同样的功能，难度往往是其他语言的几倍，但我还是更喜欢使用这种神奇而又有趣的语言，特别是读完STL源码剖析后更加坚定了我的目标。