Qt中如何启动Sqlite立即事务？多用户访问数据异常

能不能通过QSqlDatabase::transaction()指定事务类型？ #

不行。QSqlDatabase::transaction()是Qt提供的跨数据库通用事务接口，针对SQLite时默认启动DEFERRED事务，它本身不支持直接传入参数指定IMMEDIATE这类SQLite专属的事务类型。

正确启动SQLite立即事务的两种方式 #

方式一：手动执行SQL控制事务全程

直接用BEGIN IMMEDIATE启动事务，配合COMMIT/ROLLBACK完成提交或回滚，注意不要和Qt的transaction()/commit()/rollback()混用，避免事务状态跟踪混乱。

示例代码：

QSqlDatabase db = /* 获取你的数据库连接 */;
QSqlQuery query(db);

// 启动立即事务，必须检查执行结果
if (!query.exec("BEGIN IMMEDIATE;")) {
    qDebug() << "启动立即事务失败:" << query.lastError().text();
    return;
}

// 执行业务操作，每一步都要检查结果
bool operationSuccess = true;
if (!query.exec("INSERT INTO your_table (col1) VALUES ('test')")) {
    qDebug() << "写入失败:" << query.lastError().text();
    operationSuccess = false;
}

// 根据操作结果提交或回滚
if (operationSuccess) {
    if (!query.exec("COMMIT;")) {
        qDebug() << "提交失败:" << query.lastError().text();
        query.exec("ROLLBACK;");
    }
} else {
    query.exec("ROLLBACK;");
}

方式二：修改SQLite默认事务模式

通过执行PRAGMA default_transaction_mode = IMMEDIATE;，将SQLite的默认事务类型改为IMMEDIATE，之后调用Qt的transaction()就会自动启动立即事务，适合已经大量使用Qt事务API的项目。

示例代码：

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("your_db.db");
if (!db.open()) {
    qDebug() << "数据库打开失败:" << db.lastError().text();
    return;
}

// 设置默认事务模式为IMMEDIATE
QSqlQuery pragmaQuery(db);
if (!pragmaQuery.exec("PRAGMA default_transaction_mode = IMMEDIATE;")) {
    qDebug() << "设置默认事务模式失败:" << pragmaQuery.lastError().text();
}

// 现在调用transaction()就是启动IMMEDIATE事务
if (db.transaction()) {
    QSqlQuery query(db);
    // 执行读写操作...
    if (!query.exec("UPDATE your_table SET col1 = 'update' WHERE id = 1")) {
        qDebug() << "更新失败:" << query.lastError().text();
        db.rollback();
        return;
    }

    if (!db.commit()) {
        qDebug() << "提交失败，回滚";
        db.rollback();
    }
}

关键注意事项 #

• 无论哪种方式，都必须检查每一步SQL的执行结果，BEGIN IMMEDIATE可能因为其他连接持有锁而失败，此时需要根据业务场景处理重试或提示
• 事务过程中避免执行DDL语句（如CREATE TABLE、ALTER TABLE），SQLite会自动提交当前事务，导致立即事务的锁失效
• 不要混合使用Qt事务API和手动SQL事务语句，比如先调用db.transaction()再执行BEGIN IMMEDIATE，会导致事务状态冲突

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