Qt C++项目借助Excel初始化SQLite数据库遇连接相关错误

所有报错本质都来自Qt数据库连接的全局生命周期管理违规，没有满足Qt对数据库连接创建、析构的强制规则，对应每条报错的具体触发逻辑：

• 第一条connection 'qt_sql_default_connection' is still in use报错：调用removeDatabase()删除默认连接时，绑定到该连接的QSqlQuery对象未销毁、存在未提交的活动事务/未完成查询，Qt为避免野指针引用已删除的连接，会强制标记后续所有该连接上的查询失效。
• 第二条、第三条duplicate connection name报错：使用相同连接名重复调用addDatabase()创建新连接，且同名旧连接没有被主动从全局注册表移除；Qt检测到重名后会静默覆盖删除旧连接，这步操作本身就是触发第一条“连接仍在使用”报错的直接诱因。
• 你遇到的xlsx_connection重名报错，说明在Excel解析逻辑中也复用了固定连接名做重复创建，没有做连接存在性校验。

*注：绝大多数开发者踩的共性坑是：误以为函数内创建的局部QSqlDatabase对象离开作用域后连接会自动销毁，实际上Qt的数据库连接维护全局注册表，局部对象仅断开引用、连接本体仍保留在注册表中，下次用同名创建就必然触发重名覆盖。

• 修正连接创建逻辑，创建前先校验同名连接是否存在，避免无意义的重名覆盖：

  const QString DEFAULT_SQLITE_CONN = "qt_sql_default_connection";
  QSqlDatabase dbInstance;
  // 先检查全局连接表中是否已存在该连接
  if(QSqlDatabase::contains(DEFAULT_SQLITE_CONN)) {
      // 直接复用已注册的连接，不要重复调用addDatabase
      dbInstance = QSqlDatabase::database(DEFAULT_SQLITE_CONN);
  } else {
      // 仅当连接不存在时，才新建并注册到全局表
      dbInstance = QSqlDatabase::addDatabase("QSQLITE", DEFAULT_SQLITE_CONN);
      dbInstance.setDatabaseName("your_local_sqlite.db");
      dbInstance.open();
  }
  

• 严格遵守Qt的连接析构顺序：所有绑定到特定连接的QSqlQuery、绑定到连接的业务对象，必须在调用removeDatabase()之前全部销毁、释放引用。
  例如Database类内部持有QSqlQuery m_boundQuery成员时，析构流程必须是：先执行m_boundQuery = QSqlQuery();清空引用，再调用QSqlDatabase::removeDatabase(连接名)，禁止先移除连接、再销毁绑定的查询对象。
• 隔离临时连接的生命周期：你提到的xlsx_connection这类仅用于Excel解析的临时连接，在解析流程完成后及时清理；清理前确认该连接上无未释放的查询对象，避免临时连接名长期留在全局注册表中，被后续逻辑重复复用导致重名。
• 避坑提示：不要在数据库连接处于打开状态时直接让关联对象离开作用域，Qt不会自动完成安全的连接移除逻辑，必须显式执行全链路的清理动作。

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