Qt：如何安全捕获SQLite数据库的外部变更？

我帮你梳理下这个问题的解决方案，结合你已经做的尝试，咱们从几个维度来完善，确保能覆盖所有你提到的场景：

你之前遇到的commit()与监控不同步、写入中无法捕获外部变更的问题，可以通过状态快照+延迟检查来解决：

1. 记录文件基准状态
   在每次写入操作开始前，先获取数据库文件的QFileInfo快照（包括修改时间、文件大小、存在性），保存为基准状态；写入完成后更新这个基准。

2. 改进changed信号处理逻辑

   • 当处于写入状态时，不直接忽略信号，而是标记「待检查」状态；
   • 写入完成后，立即对比「写入前基准」和「当前文件状态」，判断写入过程中是否有外部变更；
   • 对changed信号做防抖处理（比如用QTimer延迟500ms再执行检查），避免系统触发多次信号导致误判。

示例代码片段：

// 类成员变量
bool m_writeInProgress = false;
bool m_pendingChangeCheck = false;
QFileInfo m_lastDbFileInfo;
QTimer* m_changeDebounceTimer;
QString m_dbPath;

// 写入操作逻辑
void performDatabaseWrite() {
    m_writeInProgress = true;
    QFileInfo preWriteInfo(m_dbPath); // 记录写入前状态

    // 执行你的写入操作
    QSqlQuery query(m_db);
    if (!query.exec("INSERT INTO your_table VALUES (...)")) {
        qDebug() << "Write failed:" << query.lastError().text();
    }
    m_db.commit();

    // 写入完成后检查是否有待处理的外部变更
    m_writeInProgress = false;
    if (m_pendingChangeCheck) {
        m_pendingChangeCheck = false;
        checkAndHandleExternalChange();
    }
    // 更新基准状态
    m_lastDbFileInfo = QFileInfo(m_dbPath);
}

// 文件变更信号槽
void onDbFileChanged(const QString& path) {
    if (m_writeInProgress) {
        m_pendingChangeCheck = true;
        return;
    }
    // 防抖：延迟处理，避免重复触发
    m_changeDebounceTimer->start(500);
}

// 防抖后的检查逻辑
void onDebounceTimeout() {
    m_changeDebounceTimer->stop();
    checkAndHandleExternalChange();
}

// 核心检查函数
void checkAndHandleExternalChange() {
    QFileInfo currentInfo(m_dbPath);
    // 检查文件是否存在
    if (!currentInfo.exists()) {
        qDebug() << "Database file was deleted/moved!";
        handleDbLoss(); // 自定义处理逻辑：提示用户、重建数据库等
        return;
    }
    // 检查读写权限
    if (!currentInfo.isReadable() || !currentInfo.isWritable()) {
        qDebug() << "Database file permission changed!";
        handlePermissionError();
        return;
    }
    // 对比修改时间和大小，判断是否有外部修改
    if (currentInfo.lastModified() != m_lastDbFileInfo.lastModified() 
        || currentInfo.size() != m_lastDbFileInfo.size()) {
        qDebug() << "Database file was modified externally!";
        handleExternalModification();
        // 更新基准状态
        m_lastDbFileInfo = currentInfo;
    }
}

文件监控可能存在边缘场景失效的情况，所以每次数据库操作后都要主动检查错误，这是最可靠的兜底方案：

比如当文件被删除后，下一次执行SQL操作（查询、写入、甚至重新连接）会返回明确的错误信息，你可以统一封装数据库操作函数，在每次操作后检查：

bool executeSqlQuery(QSqlDatabase& db, const QString& sql) {
    QSqlQuery query(db);
    if (!query.exec(sql)) {
        QSqlError err = query.lastError();
        // 判断是否是文件丢失/权限错误
        if (err.type() == QSqlError::ConnectionError) {
            QString errText = err.text();
            if (errText.contains("unable to open database file") 
                || errText.contains("permission denied")) {
                handleDbAccessError(); // 触发对应的处理逻辑
            }
        }
        qDebug() << "SQL error:" << err.text();
        return false;
    }
    return true;
}

QFileSystemWatcher在某些系统环境下可能出现监控失效（比如文件被移动后再移回、系统文件事件丢失），所以可以加一个QTimer定期（比如10秒一次）主动检查数据库文件状态，作为补充：

// 初始化时设置定期检查
QTimer* m_periodicCheckTimer = new QTimer(this);
connect(m_periodicCheckTimer, &QTimer::timeout, this, &YourClass::checkAndHandleExternalChange);
m_periodicCheckTimer->start(10000); // 每10秒检查一次

你已经用PRAGMA locking_mode = EXCLUSIVE; BEGIN EXCLUSIVE; COMMIT;解决了其他连接修改的问题，这里补充两个细节：

• 确保在程序正常退出时主动提交或回滚事务，避免异常退出后锁残留（SQLite会自动处理崩溃后的锁，但正常退出尽量手动释放）；
• 如果你的程序需要长时间持有独占锁，注意处理用户强制关闭程序的场景，避免影响其他进程访问。

通过「QFileSystemWatcher优化监控+数据库操作错误检测+定期主动检查」的组合方案，可以全面覆盖：

• 文件被删除/移动的情况；
• 权限变更的情况；
• 外部程序修改数据库的情况；
• 写入过程中发生的外部变更。

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