Qt中QSqlDatabase读取Excel：构造函数可用按钮调用报错问题

我可以读取XLSX格式的Excel文件数据，但仅当读取代码作为QMainWindow构造函数的一部分时才能正常运行。初始测试时这种方式没问题，但将读取逻辑移至独立函数并通过按钮点击触发调用时，会弹出错误提示“操作系统未配置为运行此应用程序”。

使用环境：Windows 10 / Qt 5.15.2 / MinGW

构造函数代码 #

t_ps_bps_grad2::t_ps_bps_grad2(QWidget *parent)
  : QMainWindow(parent)
  , ui(new Ui::t_ps_bps_grad2)
/* ************************************************************************** */
{
  ui->setupUi(this);
  db = QSqlDatabase::addDatabase("QODBC", "xlsx_connection");
  // 从此处调用可正常运行：loadExcel();
}

读取Excel的函数代码 #

void t_ps_bps_grad2::loadExcel()
/* ************************************************************************** */
{
  QString pathToExcel = "C:\data.xlsx";
  QString excelDriver = "DRIVER={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};DBQ=" + pathToExcel;

  db.setDatabaseName(excelDriver);

  if (db.open()) {
    QSqlQuery *query = new QSqlQuery(db);
    if (query->exec("select * from [Data$A1:B20000]")) {
      while (query->next()) {
        double double_p = query->value(0).toDouble();
        // ...
      }
    } 
  }
}

void t_ps_bps_grad2::on_pushButton_clicked()
/* ************************************************************************** */
{
  loadExcel(); // 从此处调用无法正常运行！
}

问题根源及解决方法 #

1. ODBC驱动位数不匹配
   Qt用MinGW编译的程序位数（32/64位）必须和安装的Excel ODBC驱动位数完全一致。构造函数阶段可能因加载逻辑掩盖了匹配问题，按钮触发时则暴露出来。

   • 解决：若为MinGW 32位，安装32位版Microsoft Access Database Engine；若为64位MinGW，安装64位版本。

2. 数据库连接对象状态异常
   构造函数中创建的db对象在按钮点击时可能存在未正确关闭的旧连接，或作用域导致的状态问题。

   • 解决：在loadExcel内创建独立的连接对象，避免复用旧连接：

     void t_ps_bps_grad2::loadExcel()
     {
       // 修正路径转义问题
       QString pathToExcel = "C:\\data.xlsx"; 
       QString excelDriver = "DRIVER={Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb)};DBQ=" + pathToExcel;
     
       // 用唯一连接名避免冲突
       QString connName = "xlsx_conn_" + QUuid::createUuid().toString();
       QSqlDatabase db = QSqlDatabase::addDatabase("QODBC", connName);
       db.setDatabaseName(excelDriver);
     
       if (db.open()) {
         QSqlQuery query(db); // 栈对象替代new，避免内存泄漏
         if (query.exec("select * from [Data$A1:B20000]")) {
           while (query.next()) {
             double double_p = query.value(0).toDouble();
             // ...
           }
         }
         db.close();
       }
       // 移除连接，清理资源
       QSqlDatabase::removeDatabase(connName);
     }
     

3. 路径转义错误
   原代码中"C:\data.xlsx"的反斜杠未转义，会被解析为无效转义字符，导致文件路径错误。

   • 解决：改为"C:\\data.xlsx"或使用正斜杠"C:/data.xlsx"。

4. 文件权限问题
   按钮触发时程序可能没有读取C:\data.xlsx的权限（构造函数阶段可能以管理员权限运行）。

   • 解决：将Excel文件移至用户目录（如C:\Users\你的用户名\data.xlsx）测试，或确保程序有对应路径的读取权限。

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