解决sqflite在Web调试时数据库不持久化的问题

在使用Flutter的sqflite插件进行Web开发时，开发者可能会遇到一个常见问题：在调试过程中，每次重新运行应用都会触发数据库的onCreate回调，导致数据无法持久化保存。本文将深入分析这一现象的原因，并提供有效的解决方案。

问题现象

当开发者在Web环境下使用sqflite_common_ffi_web插件时，可能会观察到以下现象：

1. 使用IDE(如IntelliJ)调试时，每次重新运行应用都会触发数据库的onCreate回调
2. 数据无法在多次运行间保持持久化
3. 使用生产构建(flutter build web)后部署的应用却能正常保持数据

根本原因

这个问题的核心在于Web环境下IndexedDB(Web SQL的后端存储)的存储机制。在Web平台，数据库的存储是基于域名的，而调试时IDE通常会使用随机端口，导致每次运行都被视为不同的"域名"。

具体来说：

• 生产环境下使用固定域名和端口，数据库能正常持久化
• 调试模式下端口变化会被视为不同来源(origin)，触发新的数据库创建
• 即使手动指定相同端口(--web-port)，某些IDE可能仍会重置存储

解决方案

1. 确保使用固定调试端口

在运行Flutter Web应用时，通过命令行指定固定端口：

flutter run -d chrome --web-port 8080

或者在IDE的运行配置中添加--web-port参数。

2. 检查IDE的调试行为

某些IDE(如IntelliJ)可能有特殊的调试行为：

• 确认端口确实固定不变(可在浏览器地址栏查看)
• 检查是否启用了"清除缓存和硬重载"等选项
• 尝试使用命令行直接运行，排除IDE干扰

3. 验证数据库路径

确保数据库路径是固定的，避免因路径变化导致创建新数据库：

final database = await openDatabase(
  'my_database.db',
  onCreate: (db, version) {
    // 初始化代码
  },
);

4. 生产环境验证

如果生产构建的应用能正常持久化数据，则确认是调试环境特有的问题，可专注于调试配置的调整。

深入理解

Web环境下，sqflite_common_ffi_web插件实际上是基于Web SQL API实现的，而Web SQL的后端存储通常是IndexedDB。浏览器安全模型要求同源策略，这意味着：

• 不同协议(http/https)、域名或端口都被视为不同来源
• 每个来源有独立的存储空间
• 端口变化会被视为跨源，创建新的数据库实例

理解这一点后，开发者就能明白为什么固定端口对数据持久化如此重要。

最佳实践

1. 开发阶段始终使用固定端口调试
2. 在代码中添加日志，输出当前数据库路径和版本
3. 定期备份重要测试数据
4. 考虑使用mock或内存数据库进行单元测试

通过以上方法，开发者可以有效解决Web调试时sqflite数据库不持久化的问题，提高开发效率。