HarmonyOS鸿蒙Next中relationalStore到底支不支持foreign_keys？

学到了，为你点赞！

relationalStore 底层是 SQLite，所以“语法层面”当然能写 FOREIGN KEY (...) REFERENCES ...，文档也确实把“外键”列在 SQLite 特性里（说明能力目标上是支持的）。

但你遇到的 “PRAGMA foreign_keys = ON; 执行了却不生效”，在实际工程里最常见的原因不是编译选项，而是：

关键点：PRAGMA foreign_keys 是“连接级别”的，而 RdbStore 有连接池

SQLite 的外键开关是 per-connection 的：你在哪个连接上 PRAGMA foreign_keys=ON，只对那个连接生效。
而 HarmonyOS/OpenHarmony 的 RdbStore 常驻有多条读连接 + 1 条写连接（连接池），你在某次 store.execute() 上执行 PRAGMA，很可能只命中了某一条连接；后续 insert/update/delete 又走到了另一条连接（外键仍是 OFF），于是你感觉“没启用”。

这也解释了你看到的现象：接口说支持 PRAGMA，但“全局外键约束”看起来没打开。

你可以这样验证到底是不是这个原因

1. 先执行：

   PRAGMA foreign_keys;
   

   看返回是 0 还是 1（不同接口返回形式略有差异，但原则是要能读出当前连接的状态）。

2. 做一个最小用例验证约束是否触发：

3. 建 parent/child 两张表（child 声明 foreign key）

4. 往 child 插入一个不存在的 parent_id

5. 如果外键真的开启，应报 FOREIGN KEY constraint failed

6. ---

   可落地的规避方案（推荐）：把“启用外键 + 相关写操作”放在同一个 Transaction 里

   createTransaction() 往往会让后续 SQL 落在同一条连接上（至少在该事务上下文内更可控），你可以这样做：

   const tx = await store.createTransaction({});
   await tx.execute('PRAGMA foreign_keys = ON');
   await tx.execute('PRAGMA foreign_keys'); // 可选：确认=1
   
   // 在同一个 tx 里做建表/插入/更新/删除
   await tx.execute(`INSERT INTO child(parent_id, ...) VALUES (?, ...)`, [123]);
   
   await tx.commit();
   

   如果你用事务包住后外键开始生效，基本就能确认：问题是连接池导致的“PRAGMA 不全局”。

   ---

   如果你希望“整个应用里永远开启外键”

   目前 ArkTS 的 relationalStore 没有公开一个“全局默认开启 foreign_keys”的配置项（你看到 compile_options 也拿不到是同一类原因：被封装了）。所以你通常只能选：

7. 业务上强依赖外键约束：把关键写操作尽量放到同一个 Transaction 中，并在事务开始时执行 PRAGMA foreign_keys=ON。

8. 不依赖外键：用触发器（trigger）/应用层校验/级联删除逻辑替代（更可控、跨连接不受影响）。

9. Sources:

10. OpenHarmony 文档：关系型数据库基于 SQLite，支持事务、索引、视图、触发器、外键等特性（说明“外键”能力在目标范围内）：https://github.com/openharmony-rs/openharmony-docs/blob/master/zh-cn/application-dev/database/data-persistence-by-rdb-store.md

11. ---