PowerSync

[!info] related notes

• 相关概念: Service Worker 与 Cache API, Local First, sqlite
• 相关场景: power-sync-docker容器启动失败探查, dailyuse本地登录流程和powersync同步问题

PowerSync 是一个专为**离线优先（Offline-first）**应用设计的同步层中间件。它主要解决的问题是如何让移动端或 Web 端应用在断网时依然能读写本地数据库，并在恢复网络后，自动、高效地将数据与后端 SQL 数据库同步。

简单来说，它是连接 客户端 SQLite 和 服务端 Postgres 之间的“高速公路”。

---

核心工作原理

PowerSync 的核心机制是流式同步（Streaming Sync）。它不像传统的 REST API 那样通过“请求-响应”来获取数据，而是维持一个持久的连接，将数据库的变更像视频流一样推送给客户端。

1. 后端绑定：它连接到你的主数据库（通常是 PostgreSQL）。
2. 增量同步：利用 Postgres 的逻辑复制（Logical Replication），它只捕获数据的变化（Insert/Update/Delete）。
3. 客户端持久化：客户端直接操作本地的 SQLite 数据库。这意味着 UI 响应速度是毫秒级的，不受网络延迟影响。
4. 自动冲突解决：当网络恢复时，本地排队的变更会自动推送到云端。

---

为什么开发者选择 PowerSync？

1. 极速的交互体验

由于数据直接从本地设备读取，应用可以实现“零延迟”加载。用户不需要看到加载圈（Spinner），即使在隧道、飞机等弱网环境下也能正常工作。

2. 简化开发逻辑

传统的同步需要手动处理大量 API 调用、复杂的缓存状态管理（如 React Query/SWR 的深度配置）以及离线队列。PowerSync 把这些抽象成了数据库层面的同步，你只需要编写 SQL 语句即可。

3. 与现有后端兼容

与 Firebase 或 Supabase Realtime 不同，PowerSync 不需要你更换整个后端架构。

• 你可以保留现有的 Node.js/Python/Go 后端。
• 它不接管你的身份认证（Auth），你可以继续使用现有的方案。

---

技术架构组成

组件	作用
PowerSync Service	负责解析 Postgres 变更日志并将其分发给正确的用户。
Client SDK	运行在用户设备上（支持 Flutter, React Native, Web, Kotlin 等），管理本地 SQLite。
Sync Rules	一种声明式配置，定义哪些数据子集应该同步给特定的用户（类似 Row Level Security）。

---

适用场景

• 现场作业应用：如工程师在没有信号的地下室记录数据。
• 协作工具：如需要多人实时编辑的任务管理器或文档工具。
• 高性能移动应用：追求极致流畅感，不希望用户在切换页面时等待 API 返回。

局限性

虽然它非常强大，但也有一些需要权衡的地方：

• 数据量限制：由于数据要下载到本地 SQLite，不适合在手机端同步 TB 级的海量数据（需要通过 Sync Rules 精确控制同步范围）。
• 数据库支持：目前对 PostgreSQL 的支持最成熟，虽然也在扩展其他数据库，但非 SQL 后端的集成会比较麻烦。

你想了解如何在具体的框架（比如 Flutter 或 React Native）中集成 PowerSync 吗？