Sqlite 删除数据库文件后onCreate回调未触发问题咨询
删除Sqlite数据库文件后onCreate回调不触发问题
问题现象
在基于sqflite的Sqlite开发场景中,手动移除应用存储目录下的数据库文件后,重新初始化数据库时本该触发的onCreate方法未执行,仅首次安装运行应用时onCreate能正常生效。
最小复现代码
数据库工具类代码
class Helper { Database _db; Future<Database> initDb() async { if (_db == null) { final directory = await getApplicationDocumentsDirectory(); _db = await openDatabase(join(directory.path, 'foo.db'), version: 1, onCreate: _onCreate); } return _db; } Future<void> _onCreate(Database db, _) async { print('onCreate'); await db.transaction((txn) async { await txn.execute('CREATE TABLE tableName(abc TEXT)'); }); } }
测试入口代码
void main() async { final directory = await getApplicationDocumentsDirectory(); final file = File(join(directory.path, 'foo.db')); if (await file.exists()) { await file.delete(); } // 执行到此处时,旧的数据库文件已被删除 final helper = Helper(); await helper.initDb(); // 预期会触发onCreate,实际未执行 }
问题根因
sqflite插件内置了数据库连接的全局缓存机制:
- 首次调用
openDatabase打开指定路径的数据库时,插件会把对应文件路径的数据库连接实例存入内部静态缓存表。 - 手动调用File.delete删除磁盘上的数据库文件时,内存中已经被缓存的数据库连接不会被同步销毁。后续再次调用
openDatabase打开同路径的数据库时,插件会直接返回已缓存的旧连接实例,不会重新执行数据库初始化流程,也就不会触发onCreate回调。 - 另外如果Helper类中作为单例缓存的
_db实例没有被置空,哪怕磁盘文件已删除,代码也会直接复用内存中的_db对象,跳过初始化逻辑。
解决方法
- 清理数据库时不要直接手动删除磁盘文件,优先使用插件提供的
databaseFactory.deleteDatabase(数据库文件绝对路径)方法,该方法会自动完成「强制关闭对应路径的所有数据库连接-清空插件内部连接缓存-删除磁盘上的数据库文件」的全流程操作,避免残留的内存连接影响后续初始化。 - 开发调试阶段如果遇到缓存未清理的异常,可以先调用
databaseFactory.closeDatabase(数据库文件绝对路径)方法手动关闭对应路径的所有连接、清空缓存,再重新执行数据库初始化流程,onCreate就会按预期触发。
内容的提问来源于stack exchange,提问作者iDecode
相关产品推荐
相关产品推荐

