PGLite：將完整PostgreSQL資料庫帶入瀏覽器和Node.js（WebAssembly驅動）

背景：数据库进入浏览器时代

长期以来，数据库一直是服务器端的专属领域。PostgreSQL 作为世界上最先进的开源关系型数据库，体积庞大、依赖繁多，从未被认为能在浏览器中运行。但 PGLite 打破了这一认知：它通过 WebAssembly 技术，将完整的 PostgreSQL 数据库带入了浏览器和 Node.js 环境。这不是一个简化的模拟版本，而是真正的 PostgreSQL——支持扩展、完整 SQL 语法、事务、触发器和存储过程。

这一突破背后，是 WebAssembly（WASM）技术的成熟。WASM 允许将 C/C++ 等语言编写的代码编译为可在浏览器中高效运行的二进制格式，性能接近原生代码。PGLite 正是利用了 Emscripten 工具链，将 PostgreSQL 的 C 源代码编译为 WASM 模块。

技术实现：从 C 代码到浏览器

Emscripten 编译链

PGLite 的核心是使用 Emscripten 将 PostgreSQL C 代码编译为 WebAssembly。这个过程并不简单——PostgreSQL 的代码库有数十年历史，包含大量平台相关的系统调用。团队需要处理文件系统抽象、进程模型差异、网络接口缺失等一系列挑战。

最终的 WASM 包压缩后约 3MB，对于现代 Web 应用来说是完全可接受的体积。

存储层设计

数据持久化是浏览器环境中的难题。PGLite 采用双模式存储策略：

• **浏览器环境**：数据存储在 IndexedDB 中，这是浏览器提供的原生键值存储，支持事务，容量可达数百 MB
• **Node.js 环境**：直接使用文件系统，行为与传统 PostgreSQL 更接近

初始化与连接

与传统 PostgreSQL 不同，PGLite 无需启动独立进程。开发者只需引入 npm 包，即可在几行代码内创建一个完整的 PostgreSQL 实例：

import { PGlite } from '@electric-sql/pglite';
const db = new PGlite();
await db.exec('CREATE TABLE users (id SERIAL, name TEXT)');
const result = await db.query('SELECT * FROM users');

核心应用场景

离线优先应用（Offline-First）

这是 PGLite 最引人注目的使用场景。传统 Web 应用依赖网络连接访问数据库，一旦断网功能即受限。引入 PGLite 后，应用可以在本地 PostgreSQL 实例中处理所有数据操作，网络恢复后再通过同步机制与服务器数据库合并。这对野外作业、航空、医疗等弱网或无网环境的应用尤为重要。

开发与原型阶段

搭建本地开发环境历来耗时——安装 PostgreSQL、配置连接、初始化 schema……PGLite 彻底简化了这个流程。开发者可以直接在浏览器 DevTools 的控制台中运行 SQL 查询，无需任何额外安装。这对于快速验证想法、演示 Demo、教学培训都极为便利。

单元测试与集成测试

测试中使用真实数据库往往因启动慢、状态残留等问题令人头疼。PGLite 可以在每个测试用例中快速创建全新的 PostgreSQL 实例，测试完成后即刻销毁，完全隔离、速度极快。

边缘计算（Edge Computing）

随着 Cloudflare Workers、Deno Deploy 等边缘运行时的普及，在靠近用户的节点运行轻量级数据库成为可能。PGLite 的 WASM 特性使其天然适合这类环境。

技术局限性

PGLite 并非万能，有几个关键限制需要了解：

• **并发性能**：WASM 目前以单线程运行，无法充分利用多核 CPU，高并发写入场景不适合
• **存储配额**：浏览器对 IndexedDB 的存储有限制，通常为磁盘空间的一定百分比，大数据量场景受制约
• **扩展支持**：并非所有 PostgreSQL 扩展都能编译为 WASM，PostGIS 等重量级扩展暂不支持
• **网络功能**：浏览器安全模型禁止直接 TCP 连接，因此无法用于主从复制等需要网络的场景
• **内存限制**：浏览器对单个 Tab 的内存使用有上限，超大型数据集处理受限

与竞品的对比

市场上也有其他轻量级浏览器内数据库方案，如 SQLite WASM（官方出品）和 Absurd-SQL。相比之下，PGLite 的核心优势在于完整的 PostgreSQL 兼容性——如果你的生产环境跑的是 PostgreSQL，那么 PGLite 在开发和测试阶段能提供最接近生产的环境，减少"在我机器上可以跑"的问题。

展望：数据库本地化趋势

PGLite 是"数据库本地化"这一更大趋势的缩影。随着 WASM 性能持续改善（WASM GC、WASM Threads 等新特性陆续落地），越来越多原本需要专用服务器的功能将迁移到客户端。结合 CRDTs（无冲突复制数据类型）和本地优先架构，未来的 Web 应用可能大量采用"本地数据库 + 云端同步"的模式，彻底改变当前以服务器为中心的架构范式。

对于开发者而言，现在正是探索 PGLite 的好时机——它不仅是一个有趣的技术玩具，更可能是下一代 Web 应用架构的重要组成部分。