Qt Android应用SQLite连接成功但查询提示表不存在问题排查

• Qt的QSQLITE驱动在Android平台的文件路径解析逻辑和桌面端存在本质差异
• 你在.pro配置中将test.db打包到APK内部/assets目录的操作本身没有问题，但这个路径是APK压缩包内的只读虚拟路径，不属于真实文件系统的可访问路径，SQLite无法对压缩包内的虚拟文件执行所需的随机读写操作
• 你代码中传入相对路径test.db作为数据库名称时，QSQLITE驱动在Android端会自动将路径映射到应用私有数据目录下。由于初始状态下该目录不存在对应的数据库文件，驱动会按照SQLite的默认行为，自动创建一个全新的空数据库文件——这就是为什么连接按钮会返回"yea"的成功提示，但这个自动生成的空库没有任何表结构，执行criterion表查询时自然会抛出no such table:criterion的错误，全程没有加载你预先打包的带完整表结构的数据库文件。

• 保留现有.pro文件中的assets部署配置，不需要做修改
• 重构数据库初始化流程，在打开数据库前先完成预置文件的拷贝：
  1. 调用QStandardPaths::writableLocation(QStandardPaths::AppDataLocation)获取应用私有目录的可写绝对路径，该路径下的文件不需要申请额外存储权限，完全支持SQLite的随机读写需求
  2. 检测目标可写路径下是否已经存在拷贝完成的test.db文件；如果不存在，从Android系统的assets虚拟路径assets:/test.db读取预置数据库的全部二进制内容，写入到可写路径下的test.db文件中
     示例拷贝逻辑参考：

  // 获取可写目录下的数据库完整路径
  QString dbFullPath = QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) + "/test.db";
  QFileInfo dbFileInfo(dbFullPath);
  // 检测是否需要拷贝预置数据库
  if (!dbFileInfo.exists()) {
      QFile prebuiltDb("assets:/test.db");
      if (prebuiltDb.open(QIODevice::ReadOnly)) {
          QFile targetDb(dbFullPath);
          if (targetDb.open(QIODevice::WriteOnly)) {
              targetDb.write(prebuiltDb.readAll());
              targetDb.close();
          }
          prebuiltDb.close();
      }
  }
  

  3. 修改数据库连接代码，将db.setDatabaseName()的参数替换为刚才获取的数据库完整绝对路径，不再使用相对路径
• 几个需要规避的常见坑：
  • 不要直接把assets路径传入setDatabaseName()，SQLite无法操作APK压缩包内的虚拟文件
  • 不要把数据库放置在外部存储路径，Android 10及以上的分区存储机制会引入不必要的权限问题，应用私有目录是最优选择
  • 必须增加拷贝流程的错误日志输出，避免后续出现拷贝失败时驱动静默生成空数据库的迷惑性问题

关键提醒：QSQLITE驱动的连接成功提示不代表它加载了你预先准备的数据库文件——只要目标路径可写，哪怕路径下没有文件，驱动都会通过自动创建空库的方式返回连接成功，所有的表结构错误只会在执行查询语句时才会暴露。

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