Encore.ts 中集成 Drizzle ORM 的技术实践

背景介绍

Encore.dev 是一个现代化的后端开发平台，它提供了简单易用的数据库管理功能。在 TypeScript 生态中，ORM（对象关系映射）工具是开发者常用的数据库操作方式。Drizzle ORM 作为一个新兴的 TypeScript ORM 解决方案，以其轻量级和类型安全著称。

Encore 与 ORM 的兼容性演进

最初，Encore 官方文档明确指出不支持 Prisma 和 Drizzle 这类 ORM 框架，主要原因是 Encore 使用纯 SQL 迁移文件进行数据库迁移。然而，随着技术发展，特别是 Drizzle ORM 自身功能的完善，这种兼容性限制已经发生了变化。

Drizzle ORM 的迁移方案

Drizzle ORM 提供了三种迁移策略，其中"代码优先"（codebase first）的方式特别适合与 Encore 集成：

1. Schema 作为唯一真实来源：开发者维护 TypeScript 的 Drizzle Schema 定义
2. 生成 SQL 迁移文件：通过 drizzle-kit generate 命令基于 Schema 变更生成 SQL 迁移文件
3. 应用迁移：使用 Encore 原生的迁移机制执行生成的 SQL 文件

实际集成验证

经过实际验证，这种集成方式确实可行：

1. 开发者首先定义 Drizzle Schema
2. 运行 drizzle-kit generate 生成 SQL 迁移文件
3. 使用 Encore 的标准流程（encore run）执行这些迁移

这种方式既保留了 Drizzle 的类型安全和开发体验，又兼容了 Encore 的数据库迁移机制。

官方支持进展

值得注意的是，Encore 团队已经正式宣布了对 Drizzle ORM 的支持，并提供了专门的文档说明。这标志着两个项目的集成已经从"可能"变为"官方推荐"的方案。

技术要点总结

1. 迁移策略：采用 Drizzle 的代码优先迁移策略，生成标准 SQL 文件供 Encore 使用
2. 类型安全：在开发阶段享受 Drizzle 提供的完整 TypeScript 类型支持
3. 生产兼容：生成的 SQL 迁移文件与 Encore 原生数据库管理完全兼容
4. 官方支持：Encore 已提供官方文档说明集成方式

这种集成方式为 TypeScript 开发者提供了更丰富的 ORM 选择，同时不牺牲 Encore 平台提供的数据库管理能力。