MariaDB执行存储过程报Commands out of sync QMYSQL无法执行查询错误如何解决？

Commands out of sync; you can't run this command now QMYSQL: Unable to execute query 报错和数据表本身损坏无关，核心原因是数据库连接的上一次查询返回的所有结果集未被完全读取或释放，就发起了新的查询请求。你的存储过程实际执行成功，也符合该报错的典型特征：写操作已落地，但结果集读取逻辑异常触发了驱动报错。你此前执行的表检查、修复等维护操作不涉及驱动层逻辑，因此无法解决问题。

排查方向 #

• 确认该存储过程是否会返回多个结果集：存储过程内如果包含多条SELECT语句、或是执行后会同时返回执行状态+查询结果，都会产生多个结果集，Qt 5.9的QMYSQL驱动默认不会主动跳过未读取的结果集。
• 检查调用存储过程的Qt代码逻辑：确认执行QSqlQuery::exec()之后，是否遍历完了所有返回的结果集，包括空的状态结果集。
• 确认是否存在复用同一个QSqlQuery对象执行多次查询、且前一次查询的结果集未主动清理的情况。
• 排查近期是否调整过数据库连接参数，比如是否开启了多语句执行、是否修改了结果集缓存的相关配置。

修复方案 #

• 调用存储过程后主动遍历所有结果集：每次执行存储过程后，循环调用QSqlQuery::nextResult()直到返回false，示例代码如下：

QSqlQuery query(dbConn);
query.prepare("CALL your_procedure_name(?)");
query.addBindValue(your_param);
if (query.exec()) {
    // 遍历全部结果集，无业务需要也必须读完释放资源
    do {
        while (query.next()) {
            // 按需处理当前结果集的行数据，无需处理可跳过该循环
        }
    } while (query.nextResult());
} else {
    qDebug() << query.lastError().text();
}

• 若不需要获取存储过程的任何返回结果，执行完成后可直接调用QSqlQuery::clear()主动释放结果集资源。
• 多线程场景下不要跨线程共享QSqlDatabase连接，每个线程单独创建独立的数据库连接，避免不同线程的查询相互干扰。
• 若以上操作均无效，可在数据库连接配置中强制开启CLIENT_MULTI_RESULTS参数，适配MariaDB 10.5版本返回多结果集的协议特性：Qt 5.9.2发布时间早于MariaDB 10.5.9，存在部分协议细节不兼容的可能。

内容的提问来源于stack exchange，提问作者SPlatten