引言
在Flutter移动端项目中依赖于SQLite的高级功能（如json_extract），在低版本的Android系统上部署时，可能会遇到函数不支持的问题。本文将指导你如何通过升级项目中使用的SQLite版本来解决这一问题。
前置条件
Flutter项目使用sqflite: ^2.3.3+1进行SQLite数据库操作。
IMBoy APP具有C2C类型的消息表，其中payload字段存储JSON字符串。
需求背景
实现“查找聊天”记录功能，涉及到对JSON字段的搜索查询，需要使用json_extract函数。
SELECT auto_id, id, type, from_id, to_id, payload, created_at, is_author, topic_id, status, conversation_uk3 FROM message WHERE 1=1 AND (json_extract(payload, '$.text') LIKE '%abc%' or json_extract(payload, '$.quote_text') LIKE '%abc%' or json_extract(payload, '$.title') LIKE '%abc%') and conversation_uk3=? ORDER BY created_at desc LIMIT 10 OFFSET 0, (OS error - 2:No such file or directory)) sql 'SELECT auto_id, id, type, from_id, to_id, payload, created_at, is_author, topic_id, status, conversation_uk3 FROM message WHERE 1=1 AND (json_extract(payload, '$.text') LIKE '%abc%' or json_extract(payload, '$.quote_text') LIKE '%abc%' or json_extract(payload, '$.title') LIKE '%abc%') and conversation_uk3=?
问题描述
在低版本的Android系统上，SQLite数据库不支持json_extract函数，导致查询失败。
具体错误：
[ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: DatabaseException(no such function: json_extract (Sqlite code 1 SQLITE_ERROR): , while compiling: SELECT auto_id, id, type, from_id, to_id, payload, created_at, is_author, topic_id, status, conversation_uk3 FROM message WHERE 1=1 AND (json_extract(payload, '$.text') LIKE '%abc%' or json_extract(payload, '$.quote_text') LIKE '%abc%' or json_extract(payload, '$.title') LIKE '%abc%') and conversation_uk3=? ORDER BY created_at desc LIMIT 10 OFFSET 0, (OS error - 2:No such file or directory)) sql 'SELECT auto_id, id, type, from_id, to_id, payload, created_at, is_author, topic_id, status, conversation_uk3 FROM message WHERE 1=1 AND (json_extract(payload, '$.text') LIKE '%abc%' or json_extract(payload, '$.quote_text') LIKE '%abc%' or json_extract(payload, '$.title') LIKE '%abc%') and conversation_uk3=? ORDER BY created_at desc
问题分析
json1扩展需要SQLite版本至少为3.38.0。
sqflite使用平台自带的SQLite，版本比较低为 3.22.0。
解决方案
为Android版本添加最新版本的SQLite库，以支持json1扩展。
操作步骤
- 下载最新版本的SQLite AAR文件并校验其SHA3-256哈希值。
下载 https://sqlite.org/2024/sqlite-android-3460100.aar ，放入 ./android/app/lib/ 目录(如果目录不存在就创建之)；
然后手动校验aar的 sha3-256
https://sqlite.org/2024/sqlite-android-3460100.aar
（SHA3-256： c3bec0e3a17349d3a7a6b9b7d9f23e4b14ae38a175469c28377cd1e7aa41f62c ）
openssl dgst -sha3-256 /Users/leeyi/project/imboy.pub/imboyflutter/android/app/lib/sqlite-android-3460100.aar
SHA3-256(/Users/leeyi/project/imboy.pub/imboyflutter/android/app/lib/sqlite-android-3460100.aar)= c3bec0e3a17349d3a7a6b9b7d9f23e4b14ae38a175469c28377cd1e7aa41f62c
- 在 ./android/app/build.gradle 文件中添加对SQLite AAR的依赖。
andriod {
...
dependencies {
...
// 添加sqlite的依赖
implementation files('lib/sqlite-android-3460100.aar')
}
}
- 在Flutter代码中初始化数据库，确保使用最新版本的SQLite。
在flutter代码中使用 sqlite-android-3460100.aar，不需要安装 依赖 sqflite_common_ffi 和 sqlite3_flutter_libs
我安装了最新版本的依赖（2024-08-15）
sqflite: ^2.3.3+1
sqflite_common_ffi: ^2.3.3
sqlite3_flutter_libs: ^0.5.24
/Users/leeyi/project/imboy.pub/imboyflutter/lib/service/sqlite.dart
在dart源码中应用
Future<Database?> _initDatabase() async {
// Init ffi loader if needed.
sqfliteFfiInit();
...
String path = await dbPath();
...
// debugPrint("> on open db path {$path}");
return await databaseFactoryFfi.openDatabase(
path,
options: OpenDatabaseOptions(
version: _dbVersion,
onConfigure: _onConfigure,
onCreate: _onCreate,
onUpgrade: _onUpgrade,
onDowngrade: _onDowngrade,
readOnly: false,
singleInstance: true,
), // 重新打开相同的文件是安全的，它会给你相同的数据库。
);
}
结果验证
- 在Android Studio里面真机调试，打印日志为：
andriod [ +225 ms] I/flutter (19060): iPrint SQLite version: [{sqlite_version(): 3.46.0}]
Future<Database?> get db async {
_db ??= await _initDatabase();
// https://developer.android.com/reference/android/database/sqlite/package-summary
// 查询 SQLite 版本
final versionResult =
await _db?.database.rawQuery('select sqlite_version();');
if (versionResult!.isNotEmpty) {
iPrint('SQLite version: $versionResult');
// ios [ +55 ms] flutter: iPrint SQLite version: [{sqlite_version(): 3.46.1}]
// andriod [ +225 ms] I/flutter (19060): iPrint SQLite version: [{sqlite_version(): 3.46.0}]
}
return _db;
}
-
真机执行“查找聊天记录”也正常了
-
理论上应该要为3.46.1才对，是吧？
我也感觉困惑，针对这个问题，我在sqlite论坛发表了帖子，https://sqlite.org/forum/forumpost/03226f767e
不管怎么样，问题还是解决了
总结
通过升级项目使用的SQLite版本，我们成功解决了在低版本Android系统上json_extract函数缺失的问题，保证了APP功能的完整性和稳定性。
唯一的缺点是 APP的打包体检有增加了 3.6M （sqlite-android-3460100.aar 还有3.6M）了，不过还是值得的.
参考资料：
- https://github.com/tekartik/sqflite/blob/master/sqflite/doc/troubleshooting.md
- https://sqlite.org/android/doc/trunk/www/index.wiki 《SQLite Android 绑定》
- https://github.com/tekartik/sqflite/tree/master/sqflite_common_ffi#readme
- https://developer.android.com/reference/android/database/sqlite/package-summary