SQLite事务删除_old表时提示'database table is locked'问题咨询

核心原因 #

1. 锁冲突：执行INSERT INTO new_table SELECT * FROM old_table时，SQLite会对old_table持有共享锁；后续DROP TABLE old_table需要排他锁，同一个事务内共享锁无法直接升级为排他锁，触发锁冲突。
2. 前置操作失败未终止事务：如果CREATE TABLE或INSERT步骤失败（比如语法错误），事务进入错误状态，后续执行DROP时会因事务上下文异常触发锁错误。
3. 未释放的语句资源：若代码中存在其他未通过sqlite3_finalize关闭的sqlite3_stmt对象，会导致表锁无法正常释放。
4. 多线程/多连接竞争：数据库连接被多线程共享，或存在其他连接访问该表，会引发锁竞争。

解决办法 #

1. 改用立即事务避免锁升级问题 #

将事务启动语句改为BEGIN IMMEDIATE TRANSACTION;，事务启动时直接获取排他锁，避免后续操作的锁冲突：

sqlite3_exec(this->connection, "BEGIN IMMEDIATE TRANSACTION;", NULL, NULL, NULL);

2. 每步操作后立即检查并输出错误 #

不要仅设置error=1，要在每次sqlite3_exec失败时立即获取错误信息，定位真实问题：

char* errMsg = nullptr;
query = "ALTER TABLE " + tableName + " RENAME TO " + tableName + "_old;";
cout << "8 " << query << endl;
if(sqlite3_exec(this->connection, query.c_str(), NULL, NULL, &errMsg) != SQLITE_OK)
{
    error = 1;
    cout << "Rename error: " << errMsg << endl;
    sqlite3_free(errMsg);
}
// 后续CREATE、INSERT、DROP操作都照此修改

3. 检查SQL语法合法性 #

重点排查colParam中的内容是否符合SQLite语法（比如NOT NULL、DEFAULT等参数是否正确），避免CREATE TABLE失败导致事务异常。

4. 确保单线程访问数据库连接 #

如果是多线程环境，保证同一时间只有一个线程操作该数据库连接，或使用连接池分配独立连接。

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