QT6 C++无法从SQL存储过程OUT/INOUT参数获取正确值

核心问题 #

调用MySQL存储过程时，即使存储过程将out_is_valid设为TRUE，Qt代码中获取到的isValid始终为false，调整参数为OUT类型也无法解决。

排查与解决步骤 #

1. 验证存储过程本身的正确性

先排除存储过程的问题，在MySQL客户端执行以下命令：

SET @is_valid = FALSE;
CALL validate_credentials('测试账号', '测试密码', @is_valid);
SELECT @is_valid;

• 如果查询返回TRUE（或1），说明存储过程逻辑正常，问题出在Qt调用环节；
• 如果返回FALSE（或0），先修复存储过程逻辑。

2. 调整存储过程参数类型与绑定方式

• 将存储过程的INOUT参数改为纯OUT参数（更符合当前场景需求）：

  CREATE PROCEDURE validate_credentials(IN in_login VARCHAR(20), IN in_password VARCHAR(20), OUT out_is_valid BOOLEAN)
  BEGIN
      -- MySQL的BOOLEAN本质是TINYINT(1)，可直接赋值1代表TRUE
      SET out_is_valid = 1;
  END;
  

• 改用bindValue指定位置绑定参数，避免addBindValue可能的顺序错误：

  query.prepare("CALL validate_credentials(?, ?, ?)");
  query.bindValue(0, login);
  query.bindValue(1, password);
  query.bindValue(2, isValid, QSql::Out);
  

3. 修正QSqlQuery获取输出参数的时机

Qt的QSqlQuery执行存储过程后，需要先触发结果集的遍历（即使存储过程没有返回数据集），才能正确读取OUT参数。在exec()成功后添加query.next()：

if(query.exec()){
    // 触发结果集刷新，确保OUT参数被读取
    query.next();
    isValid = query.boundValue(2).toBool();
    qInfo() << isValid;
}

4. 检查Qt MySQL驱动兼容性

部分旧版本的Qt QMYSQL驱动对存储过程的OUT参数处理存在bug，尝试：

• 更新Qt到最新稳定版本；
• 确保使用的MySQL驱动与MySQL服务器版本匹配。

修改后的完整代码示例 #

C++代码：

bool User::checkCredentials(){
    QSqlQuery query{};
    bool isValid{false};

    query.prepare("CALL validate_credentials(?, ?, ?)");
    query.bindValue(0, login);
    query.bindValue(1, password);
    query.bindValue(2, isValid, QSql::Out);

    if(query.exec()){
        query.next();
        isValid = query.boundValue(2).toBool();
        qInfo() << isValid;
    } else {
        qWarning() << "Failed to execute validate_credentials: " << query.lastError().text();
    }

    return isValid;
}

SQL存储过程：

CREATE PROCEDURE validate_credentials(IN in_login VARCHAR(20), IN in_password VARCHAR(20), OUT out_is_valid BOOLEAN)
BEGIN
    SET out_is_valid = 1;
END;

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