结论先说：目前不建议把 pub.dev 上的 sqlite3 2.9.4 当成“已经适配 HarmonyOS”的库直接接入。2.9.4 页面显示的平台是 Android、iOS、Linux、macOS、Web、Windows；sqlite3 包的说明里预编译 SQLite 也主要覆盖这些平台，没有列出 HarmonyOS。这个包的 native 路线本质是 dart:ffi 加底层 sqlite3 动态库，所以如果是 Flutter 鸿蒙工程，需要自己验证/移植 OHOS ABI 下的 libsqlite3.so 与 ffi 加载链路。

如果只是 HarmonyOS 原生应用里做本地数据库，建议优先用 ArkData 的 relationalStore。它底层基于 SQLite，官方提供 getRdbStore、execute/querySql、insert/update/delete 等接口，维护成本会比硬移植 Dart sqlite3 低很多。JSONB 这块也要注意：sqlite3.dart 的 jsonb 是 Dart 包侧能力，不能直接等同于系统 relationalStore 一定支持同样的 JSONB 函数，最好在真机上用 SELECT jsonb(…) 这类 SQL 做一次能力探测。

import { relationalStore } from '@kit.ArkData';

const config: relationalStore.StoreConfig = {
  name: 'app.db',
  securityLevel: relationalStore.SecurityLevel.S3
};

const store = await relationalStore.getRdbStore(getContext(this), config);
await store.execute('CREATE TABLE IF NOT EXISTS item(id INTEGER PRIMARY KEY AUTOINCREMENT, body TEXT)');
await store.execute('INSERT INTO item(body) VALUES(?)', [JSON.stringify({ name: 'demo' })]);

let rs = await store.querySql('SELECT body FROM item WHERE id = ?', [1]);
try {
  if (rs.goToNextRow()) {
    const data = JSON.parse(rs.getString(rs.getColumnIndex('body')));
    console.info(JSON.stringify(data));
  }
} finally {
  rs.close();
}

我的判断路径是：先看 pub.dev 的平台声明和 sqlite3 README，再决定是否走移植；若业务只是结构化存储，就走 HarmonyOS 官方 relationalStore。参考：pub.dev sqlite3 2.9.4：https://pub.dev/packages/sqlite3/versions/2.9.4，sqlite3 支持平台说明：https://pub.dev/packages/sqlite3，HarmonyOS relationalStore 文档：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-data-relationalstore，持久化指南：https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/data-persistence-by-rdb-store