TypeScript 项目选数据库访问层,几乎每次技术评审都会僵在一个问题:用 TypeORM 还是换 Prisma。前阵子给朋友的业务系统做适配评估时,我特意把 TypeORM、Prisma、Drizzle、MikroORM、Sequelize 五个候选装进同一个仓库,用同一批表结构和查询用例过了一遍。得出的结论很有意思——TypeORM 在 TS 生态里位置最“主流”,但也是最容易被吐槽的一个。这篇记录想把这些对比的细节摊开讲清楚,既有代码层面的差异,也有团队协作、迁移维护、出问题能不能自己接得住这些软指标。没有绝对答案,但对大多数做技术选型的人应该能省下不少弯路。
1. 为什么一说 TypeScript ORM,选型战就绕不开 TypeORM
1.1 历史地位与口碑反差从哪里来
TypeORM 是 2016 年就出现的开源项目,在 TypeScript 生态还很早期的时候,它就用装饰器和 class 来表达数据库实体,几乎成了不少团队“用 TS 写后端”时的默认选择。它的 GitHub 星标至今不低,存量项目覆盖面很广,所以你搜“TypeScript ORM”,出现在最前面的往往还是它。
但有意思的是,社区里关于 TypeORM 的吐槽也异常密集。有人嫌它类型推导不够狠,有人嫌它 API 设计前后不统一,还有人一遇到复杂查询就直接绕到 createQueryBuilder 或裸 SQL。一个项目能在社区里同时拥有“主流地位”和“被反复劝退”的双重评价,本身就说明问题不是单方面的。
这种口碑反差,本质上是早期 TypeScript 基础设施不成熟留下的债。当时 emitDecoratorMetadata、reflect-metadata、装饰器类型推断这些能力都很粗糙,TypeORM 却硬要模仿 Hibernate/JPA 那种“实体映射 + 级联操作”的完整 ORM 模型,自然会产生不少边界情况。后来 TypeScript 自身不断演进,社区对类型安全的要求也越来越高,TypeORM 的很多设计短板就被放大了。
1.2 TypeORM 的定位其实经常被误读
很多人把 TypeORM 当成“比 Sequelize 更 TypeScript 化的轻量增强版”,这其实不准确。TypeORM 想做的是类似 Hibernate、Doctrine 那种重量级全映射 ORM:加载实体后要追踪变化、级联处理关系、支持事务工作单元。这种定位决定了它比单纯 SQL builder 复杂得多,也决定了代码层的很多设计都是有代价的。
一旦把表结构映射成 class 对象,开发者就会自然希望“操作对象就像操作数据库”。比如 user.posts.push(post) 之后能否自动保存,ManyToOne 关系是否默认加载,删除父实体时子实体怎么办。这些便利背后是复杂的代理、加载策略、级联规则,一旦你对底层机制理解不够,轻则多出几条查询,重则出现隐蔽的数据一致性问题。
所以,在对比 TypeORM 和别的方案之前,我建议先问团队一个问题:你们想要的到底是“对象关系映射器”,还是“能帮我把 SQL 写得安全一点的查询工具”?这两个诉求在 TypeORM 里都被支持,但它很难两头都做到极致。这也是后面 Prisma、Drizzle 这些方案能抢走大量用户的原因。
1.3 对比阅读前,先建立一个判断框架
后文我不会简单列“谁吊打谁”,而是会沿着几条真正影响工程体验的线索展开:
- 实体和表结构如何声明,是否天然适配 TypeScript 类型系统
- schema 变更和迁移在真实项目中是否靠谱
- 查询写起来是接近 SQL 还是接近对象操作,复杂查询能不能兜住
- 事务边界、连接池、缓存这些生产细节有没有隐藏成本
- 团队上手成本、出问题后的排查难度、锁版本后的风险
如果这几个维度你能在看完整篇之后形成自己的判断,比记住某个具体结论有用得多。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 实体层设计哲学:装饰器、class 映射与“关系即对象”的真正代价
2.1 TypeORM 把数据表变成 TS class,给了你什么也拿走了什么
TypeORM 最典型的用法是装饰器实体:
typescript复制@Entity('users')
export class User {
@PrimaryGeneratedColumn('uuid')
id: string;
@Column({ length: 100 })
name: string;
@Column({ type: 'varchar', length: 50, unique: true })
email: string;
@OneToMany(() => Post, (post) => post.user)
posts: Post[];
}
这种写法相当直观,尤其适合从 Java 系转过来的开发者。你在代码里定义 class,字段写清楚,数据库表结构就基本定下来了。配合 TypeORM 的自动建表机制,开发早期能非常快地把 CRUD 跑起来。
但这里有一个很多人忽略的点:TypeORM 的 class 定义和数据库真实结构之间隔着一层工具链。你在装饰器里写的 type: 'varchar'、length: 100、unique: true,会被 TypeORM 解释成建表语句,但不同数据库方言下行为并不完全一样。MySQL 和 PostgreSQL 对默认值、自增、类型映射的处理不同,一旦线上库执行过多次迁移,实体定义是否真的和生产库 schema 保持一致,就变成一个需要长期维护的问题。
TypeORM 最经典的坑是生产环境打开了 synchronize: true,让实体变化自动同步到数据库。这个功能在开发环境确实快,但在生产环境很可能导致 TypeORM 根据对象模型差异生成 ALTER TABLE,一旦列类型变化触发重建表,麻烦就大了。我见过不止一个团队因为顺手开启 synchronize,结果某个字段类型从 varchar(255) 改成 text 时,工具生成的迁移把整个表 rebuild 了一遍,差点丢数据。所以我的建议非常直接:开发环境可以用 synchronize 省事,生产环境一律关掉,走 migration 流程。
2.2 关系注解不是自动查询开关,很多人第一步就理解错了
TypeORM 的 @ManyToOne、@OneToMany 这些装饰器给新手造成最大的误解是:我定义了关系,查询时应该会自动把关联数据带出来。
实际上,TypeORM 默认的加载策略非常保守。你不写 relations、不设置 eager: true,一个 find 只会查出当前表的数据,关联字段是一个未初始化的代理对象或者直接是 undefined。等你去访问 user.posts 的时候,它才会触发额外的查询。这个机制本身是为了避免把所有关联数据全部加载出来导致性能爆炸,但也正是 N+1 查询问题的高发源头。
正确做法是显式指定要加载的关系:
typescript复制const users = await userRepository.find({
relations: {
posts: true,
profile: true,
},
});
这行代码看着简单,实际开发里却很容易失控。比如 posts 下面还有 comments,comments 下面还有 author,你想一次性加载完整关系树,relations 就得嵌套写。每多一层嵌套,生成的 SQL join 或者 in 查询就越复杂,返回的数据量也可能远超预期。
更麻烦的是,TypeORM 的 find 选项在很多地方是纯对象加字符串键,像我这样习惯把字段名敲错的人,通常要等到运行时才看到报错。关系名、列名、where 条件里的键,全都没有编译期检查。这点上我会在后面的 Prisma 和 Drizzle 对比里重点讲,因为类型安全正是 TypeORM 和新生代产品拉开差距的关键环节。
2.3 Active Record 与 Data Mapper 都支持,但这也是复杂度来源
TypeORM 的另一个特色是同时支持两种实体模式:
- Active Record:实体类自身继承
BaseEntity,通过user.save()、user.remove()操作数据库 - Data Mapper:实体是纯数据类,操作交给
Repository,比如userRepository.save(user)
这两种模式各有适合场景。Active Record 写起来快,适合业务逻辑简单、领域对象不需要跟持久化解耦的项目;Data Mapper 更干净,实体不依赖基础设施,适合业务复杂、需要做单元测试的场景。
但“两个都支持”并不全是好事。首先,团队如果没人做主技术规范,有人用 Active Record、有人用 Repository,代码风格会非常混乱。其次,TypeORM 对这两种模式的封装并没有想象中那么彻底,实体内部如果要调用其他实体的仓库,或者想在 Active Record 方法里直接联表查询,代码很容易变得难测、难维护。
我的经验是:新项目如果选 TypeORM,第一个团队规范就应该是确定“只用 Data Mapper 还是只用 Active Record”,并且用 lint 规则或者 CR 人工卡住。两边混用看起来灵活,时间一长你就会发现每个实体文件都在按自己的方式做持久化,排查问题时比写 SQL 还累。
3. 和 Prisma 拉开差距的地方:模式定义、类型安全与代码生成
3.1 schema.prisma 是另一种“配置态”,比装饰器更直接
Prisma 和 TypeORM 最大的分水岭,是 Prisma 要求你先用一套独立 schema 语言定义数据模型,再通过 CLI 生成客户端代码:
prisma复制datasource db {
provider = "postgresql"
url = env("DATABASE_URL")
}
generator client {
provider = "prisma-client-js"
}
model User {
id String @id @default(uuid())
name String @db.VarChar(100)
email String @unique @db.VarChar(50)
posts Post[]
}
model Post {
id String @id @default(uuid())
title String
userId String
user User @relation(fields: [userId], references: [id])
}
这种设计的第一个直观好处是:数据库模型可以在不碰业务代码的状态下独立评审。你不用去理解 TypeScript class、不用想装饰器怎么解析,只要会看 schema 文件,就能参与表结构 review。对需要 DBA 或后端负责人把关数据模型的团队来说,这种约定比 TypeORM 的实体定义更容易沟通。
当然,代价也很明显。Prisma 多出一条强制工作流:每次修改 schema 后都要执行 prisma generate 重新生成客户端,本地开发时如果忘了生成,IDE 里会一直报类型错误。一些不习惯“多了一步代码生成”的开发者会觉得很烦,尤其当你只是改了一个字段名,却要等 CLI 跑完才能继续写代码。
3.2 类型安全的强度是怎么拉开差距的
Prisma 最让 TypeORM 用户眼馋的,是查询结果和参数的编译期推导。
比如你想查用户和他们的文章标题:
typescript复制const users = await prisma.user.findMany({
where: { email: { contains: "example.com" } },
select: {
id: true,
name: true,
posts: {
select: { title: true },
},
},
});
这里 where 里能写哪些字段、能配合哪些过滤条件,select 里哪些字段可以嵌套,全部由生成出来的类型严格约束。写错字段名、把 contains 用在不支持的字段上,会在编译阶段直接报错,而不是等到运行时才返回一条尴尬的 SQL 错误。
TypeORM 的 find 选项则弱在这里。它的 where 和 relations 大多是字符串键拼出来的普通对象,你写错一个关系名、字段名,类型系统几乎不会拦你。TypeORM 的 QueryBuilder 虽然能拼出任意复杂 SQL,但传入的也是字符串和对象,类型安全保障依然有限。对于强调“重构安全”和“类型先行”的 TypeScript 项目,这个差距非常致命。
不过我也得替 TypeORM 说一句公道话:Prisma 的强类型本质上是“代码生成后的定制类型”,它并不一定比你手写的类型更灵活。schema 一复杂、模型关系一多,生成出来的类型体积会变得非常大,IDE 自动补全面板经常“爆”出来一大串联合类型。团队如果只追求“能找到类型定义”而不是“类型干净”,时间久了也会发现 Prisma 的类型推导在极端情况下并不好驯服。
3.3 Prisma 卡壳的地方:复杂条件、嵌套写入与原生 SQL 边界
Prisma 在普通 CRUD 上是绝对的爽文体验,尤其是多层级嵌套 create、update,一条 API 就能把关系链写完整。但一旦要从 CRUD 跨越到复杂报表、多条件动态拼接、自定义聚合,Prisma 的查询 API 就会开始变得局促。OR、AND 的组合在某些版本里还能用,但只要条件组合多到需要动态生成,代码会变得比 SQL 本身还难读。
于是官方会建议你使用 $queryRaw 直接写原生 SQL。这个“最后兜底方案”其实很能说明问题:Prisma 的封装层并不打算替开发者解决所有查询需求,一旦打开 raw SQL 的口子,TypeORM 那种 QueryBuilder 能做的事情就又回到了你手上,只是整个过程被拆成了“封装查询用 Prisma,复杂查询用裸 SQL”两套体系。
TypeORM 在这一点上反而更“数据库原生”。createQueryBuilder 可以对着一个 model 写 leftJoin、子查询、group by、having,也能随时 .getRawMany() 拿扁平结果。很多“不那么 TypeORM”的老手在项目里留下的复杂查询代码,最后都是 QueryBuilder 加参数拼接撑起来的。
所以如果你团队的业务里,报表类、条件筛选类查询占比很高,Prisma 不一定能让你们更轻松。而如果你的系统大部分是标准后台管理界面、CRUD 比例极高,Prisma 的类型安全和嵌套写入确实能显著提升效率。
4. 折腾完 Drizzle 之后的看法:轻量 ORM 的“反 TypeORM”设计
4.1 Drizzle 不是实体框架,它是“带类型安全的 SQL builder”
Drizzle 作为新生代轻量方案,这两年受欢迎的程度很高。它的设计哲学几乎和 TypeORM 相反:不搞实体实例、不追踪变化、不把表映射成对象图,而是用 TypeScript 对象描述表结构,然后提供一套贴近 SQL 的查询构建方式:
typescript复制import { pgTable, uuid, varchar } from "drizzle-orm/pg-core";
export const users = pgTable("users", {
id: uuid("id").defaultRandom().primaryKey(),
name: varchar("name", { length: 100 }),
email: varchar("email", { length: 50 }).unique(),
});
查询起来就是你写 SQL 时的手感,但字段名、表名全部有类型提示和推导:
typescript复制const rows = await db
.select({ id: users.id, name: users.name })
.from(users)
.where(eq(users.email, "example@example.com"));
这种设计对“我不想学一套新的对象模型,我只想把 SQL 写稳”的开发者来说非常契合。它没有 TypeORM 的装饰器解析、没有懒加载代理、没有 synchronize 这类隐式行为,你看到的查询基本就是最终会发送到数据库的查询,排查问题非常直接。
4.2 没有实体缓存和级联魔法,有些代价你得到生产环境才理解
Drizzle 的类型体验确实是第一梯队的,但功能性上也做了明显减法。
TypeORM 会帮你管理实体状态,比如一个实体加载进来之后,你改字段再 save,它会尽量理解为更新而不是插入。这里面有心智成本,但也确实省心。Drizzle 没有这套变化追踪,你需要自己想清楚每一条数据是 insert 还是 update。关系预加载、级联保存这类功能也不会凭空出现,代码里必须显式用一个事务把多个表的写入包起来。
更现实的是,TypeORM 提供了很多“框架级”的能力,比如实体订阅者(subscriber)、迁移生成、软删除列、多数据库方言支持。Drizzle 把这些东西都拆散了,要靠 drizzle-kit 生成迁移、自己封装软删除逻辑、自己设计订阅和事件机制。团队如果已经习惯 TypeORM 那种“一个框架全搞定”的体验,切到 Drizzle 会有一段时间的不适。
我会做个简单的类比:TypeORM 像一套装修好的精装房,你住进去很方便,但要敲承重墙会很痛苦;Drizzle 像一套工具箱,什么都能自己拼,但没有现成的居住方案。喜欢哪种,取决于你是想快速住进去还是享受自己动手的过程。
4.3 Drizzle 适合在什么场景替换 TypeORM
对我个人来说,如果满足下面这些条件,我会很愿意把 TypeORM 换掉:
- 业务大量依赖 SQL 能力,复杂 join、子查询、窗口函数都是日常操作
- 团队不排斥写 SQL,甚至觉得 SQL 比对象映射更可控
- 对代码生成流程比较反感,希望依赖纯 TypeScript 的类型推导
- 项目部署在 Serverless 或边缘运行时,启动时间和依赖体积敏感
但如果你需要强对象建模、希望实体本身承载业务行为、想让框架帮你处理状态管理和级联规则,那 Drizzle 会显得太“裸”了。我自己见过有的团队从 TypeORM 切到 Drizzle 后,因为所有 CRUD 都要自己重新拼装,反而把之前隐藏的复杂度全部暴露出来,开发速度短期下降了不少。
5. 再把 MikroORM 和 Sequelize 放进同一个候选池
5.1 MikroORM:TypeORM 的“更严谨且更重型”进化方向
聊 TypeORM 的替代方案时,MikroORM 经常被忽略,但它和 TypeORM 的相似度最高。MikroORM 也使用装饰器实体,也支持 @Entity()、@Property() 这类声明方式,但它补上了 TypeORM 最被诟病的工作单元(Unit of Work)机制。
在 MikroORM 里,实体状态由 EntityManager 统一管理,所有加载过的实体都会进入一个身份映射表。你修改一个实体后,不需要立刻调 save,而是在 flush 时统一对比变化并生成 SQL。这让实体行为更加符合领域模型直觉,也避免了 TypeORM 里“有时改了实体但没存进去”的困惑。
但代价是学习成本极高。MikroORM 的文档相当厚,涉及到级联持久化、刷新策略、事务边界时,要理解的概念比 TypeORM 多得多。项目如果只是中等复杂度的后台系统,引入 MikroORM 反而会让团队过度设计。它更适合业务规则多、实体生命周期复杂、需要严谨状态管理的系统。
5.2 Sequelize:老牌方案,但在 TypeScript 原生体验上明显吃亏
Sequelize 是 Node 生态的老牌 ORM,资历最深,文档和社区内容存量也最大。很多团队早期用 JavaScript 写 Node 服务时就是 Sequelize,后来迁移 TypeScript 也是继续沿用。
但坦白讲,Sequelize 很难称得上“TypeScript 原生 ORM”。它的类型系统是后来补上去的,模型定义可以选择 class 风格也可以选择 define 风格,可一旦涉及复杂的 association、scope、hook,TypeScript 类型推断就会明显变弱。很多字段的自动补全和类型映射,需要手动写 interface 才能勉强达到 TypeORM 或 Prisma 的效果。
我不太建议新项目在 2025 年从零选 Sequelize,除非你维护的是老项目,团队已经有大量 Sequelize 代码和心智模型。它的稳定性和生态广度仍然有价值,但“TypeScript 体验”这一项确实不是它的强项。
5.3 五个方案放在一张表里看
| 方案 | 实体层设计 | 类型安全 | schema 与迁移 | 复杂查询体验 | 学习成本 | 更适合的项目 |
|---|---|---|---|---|---|---|
| TypeORM | class + 装饰器,AR 与 Data Mapper 双模式 | 中等,find 链路上偏弱 | migration 完整但易踩坑 | QueryBuilder 能力较强 | 中低 | 团队熟悉传统 ORM、需要快速 CRUD |
| Prisma | schema DSL 生成客户端 | 强,查询对象编译期校验 | migrate/CLI 成熟 | 复杂查询较局促,靠 raw SQL | 中 | 新项目、CRUD 密集、追求类型安全 |
| Drizzle | TS schema + query builder | 强,贴近 SQL 并推导类型 | drizzle-kit 成熟轻量 | 高,SQL 能力直接 | 中低 | 团队爱写 SQL、希望轻量部署 |
| MikroORM | class + 装饰器 + 工作单元 | 中强 | migrations/seeder 配套完整 | 强,但概念负担重 | 高 | 领域逻辑复杂、需要严谨状态管理 |
| Sequelize | define/class 兼容 | 中低,复杂模型偏弱 | 同步与迁移成熟但类型不够 TS 化 | 中 | 低 | 老项目维护、大量 JS 历史代码 |
这张表没法直接告诉你“选哪个”,但能帮你快速排除明显不适配的选项。比如你们团队已经有很好的 TypeScript 基础,那 Sequelize 大概率不值得;如果你们业务和领域模型都非常复杂,Drizzle 的精简带来的不只是简洁,还有责任转移。
6. 迁移、事务和连接池才是真正决定实践体验的细节
6.1 TypeORM 的迁移机制:能用,但有半自动的隐患
很多人在选 ORM 时只看查询 API,不太关心迁移工具。但真实生产环境里,schema 变更才是最容易出事故的环节。TypeORM 的迁移体系支持 migration:generate 帮你生成迁移文件,然后用 migration:run 执行。
听起来很顺滑,实际上有不少坑。TypeORM 生成迁移是基于实体定义和当前数据库 schema 的 diff,它对列类型变化、默认值变化的判定在不同数据库版本间并不总是可靠。我遇到过 ModifyColumn 被生成成 DropColumn + AddColumn 的情况,那个迁移文件里一旦没检查就部署,线上数据直接清空。所以 TypeORM 的迁移文件必须走人工 review,绝不能在 CI 里无脑运行自动生成的迁移。
另外,TypeORM 的实体加载机制有时会让你困惑。迁移在 CI 里执行时,如果项目配置漏掉了某个新写的实体文件,TypeORM 不会自动扫描到,于是生成的迁移缺失该表;等你本地运行正常,一上生产就报“relation does not exist”。这种问题排查起来并不直观,最终往往要检查 entities 配置是不是用了通配符、打包后的目录结构是否和本地开发一致。
Prisma 的 migrate 设计相对更安全。它的 migration 文件是按 schema 变化生成的,执行时会记录迁移历史,不太会出现 TypeORM 那种“diff 误判”造成的危险操作。Drizzle 的 drizzle-kit 也借鉴了类似思路,生成迁移后按顺序执行。单论迁移流程的可靠度,TypeORM 在三个主流方案里确实是最需要小心呵护的。
6.2 事务边界真的不是“加一个装饰器”就结束了
TypeORM 提供了非常方便的事务装饰器 @Transactional(),看起来只要在方法上加一个注解,整个方法的数据库操作就会自动进入同一个事务:
typescript复制@Transactional()
async transfer(fromId: string, toId: string, amount: number) {
// ...
}
但这个简单背后藏着不少细节。TypeORM 的 @Transactional 依赖事务管理器和代理机制,它并不是简单地把当前数据源上的所有操作包进事务。事务内如果用全局 repository 去执行查询或保存,经常会发现这些操作并没有真正走在同一个事务连接上。
这也是我在代码评审里反复看到的头号事务 bug:方法上加了 @Transactional,结果方法内部还是通过 this.userRepo 操作数据库,一旦中间某一步失败,事务并没有按预期回滚。正确做法是在事务回调里显式使用传入的 EntityManager 获取 repository:
typescript复制await dataSource.transaction(async (manager) => {
const userRepo = manager.getRepository(User);
const user = await userRepo.findOne({ where: { id: fromId } });
user.balance -= amount;
await userRepo.save(user);
});
Prisma 的 $transaction API 在这一点上更直观,它把事务操作限制在回调或交互式事务接口里,你不太容易误用。Drizzle 的 db.transaction 类似,也是把操作局限在事务客户端里。TypeORM 因为同时保留了全局 repository 和事务 manager 两条路径,反而更容易写出隐蔽问题。
另一个容易被忽视的是事务超时和锁等待。大型事务如果耗时过长,连接池会被占满,其他请求拿不到连接而集体超时。TypeORM 和 Prisma 都允许配置事务超时,但实际业务里很少有人会主动给每个事务设上限。我建议一开始就在监控里加入事务耗时和锁等待指标,别等线上故障了再回头找原因。
6.3 连接池、缓存与可观测性,藏得最深的是这些
TypeORM 的连接池依赖底层数据库驱动,常见 MySQL、PostgreSQL 驱动都有对应配置。生产环境要调整 max 连接数,否则高峰期容易疯抢连接。但这个数字不是越大越好,连接过多会压垮数据库。我通常建议从“业务并发 × 平均事务耗时”这个口径先粗略估算,再通过压测去修正。
TypeORM 还内置了一个查询缓存层,可以通过 cache: true 或 cache: { type: 'redis' } 开启。听起来很美好,但实际容易踩坑。比如你缓存了某个用户列表,另一个事务更新了用户状态后,缓存不会自动失效,必须显式配置 cache: { expirationMode: 'update' } 或自己清理。很多时候数据看起来“更新成功但查询没变化”,查到最后都是缓存惹的祸。
Prisma 在可观测性上有自己的中间件机制,但运行时引擎是独立的二进制,对日志格式、慢查询追踪的侵入性和普通 node-postgres 不太一样。Drizzle 则因为没有重型实体层,几乎直接落在驱动上,性能表现和可观测性都更贴近原生 SQL,对喜欢在数据库端做慢查询定位的团队更友好。
7. 我踩过的坑,以及最终给出的选型判断框架
7.1 TypeORM 的“find + relations”陷阱与 N+1 问题
我最早用 TypeORM 时吃过一次闷亏。业务里 User 关联 Order,Order 关联 Product,我在接口里返回用户列表,想着“反正我都在实体上写了关系,查询时会带出来的吧”。结果接口响应第一次 500ms,第二次 3 秒,第三次直接超时。打开日志一看,每次返回一个用户,TypeORM 就对 Order 表发起一次查询;返回十条用户,还要对 Product 表再发起十次查询。这就是典型的 N+1。
TypeORM 的加载策略里,主表查询不会自动把未标记 eager 的关系全部加载出来,默认的懒加载会在你访问属性时才发 SQL。真要解决问题,要么显式 relations 一次性预加载,要么用 QueryBuilder 做 join。我看到很多教程会建议“把常用关系改成 eager”,但这么做等于把每个查询都变成大杂烩,性能隐患更严重。更合理的做法是:所有加载都显式声明,所有关系默认懒加载,接口里按需决定要不要带关联数据。
7.2 版本升级不是小事,TypeORM 0.2 到 0.3 的教训
另一个让我记忆深刻的坑是 TypeORM 大版本升级。0.2 到 0.3 是一次大规模 breaking change,findOne 的返回类型、connection API、getRepository 的使用方式都有调整。团队如果守着老版本久了,升级时几乎等于重构一遍数据访问层。
这不只是 TypeORM 的毛病,Prisma 每次较大版本迭代也经常要同步升级 CLI 和客户端引擎,Drizzle 版本更迭也快。但 TypeORM 因为历史包袱重,社区对它的升级迁移文档支持并没那么细致,很多 breaking change 是在 issue 里被零散讨论的。使用 TypeORM 的项目,最好把版本锁死,并且在大版本升级前用专门的 feature branch 做全量回归,不要相信“应该只是小改动”这类侥幸心理。
7.3 我最终给团队的选择判断
如果你现在问我会给一个刚启动的 TS 项目推荐什么,我的判断会是这样:
- 项目以管理后台、普通 CRUD 为主,团队希望尽快交付,Prisma 的 schema 和类型安全能减少很多低级错误。除非你们特别反感代码生成,否则 Prisma 是当前最稳妥的大众化选择。
- 项目包含大量复杂报表、动态查询、数据库方言特性,团队又有 SQL 底子,Drizzle 会给你更直接的控制力。你能钻到 SQL 层,同时还能吃到一部分类型安全红利。
- 项目需要一个完整的领域模型,实体间关联复杂,团队愿意投入学习成本,MikroORM 的工作单元和身份映射会让生命周期管理顺畅很多。
- 维护老项目,团队已经用 Sequelize/TypeORM 熟门熟路,短时间内没必要为了“用新框架”而用新框架,把心思放在架构拆分和可测试性上更实际。
- 至于 TypeORM,它依然是 TypeScript 生态里绕不开的主流选项,也依然能支撑相当多项目正常运转。它的问题不是“不能用”,而是团队必须清楚它的边界,并且愿意在迁移、事务、类型安全这些环节额外补防护网。
就我个人的真实体会来说,如果从零开始一个新项目,我大概率不会再主动选 TypeORM。这里面的原因不完全是技术优劣,更多是对隐性成本的反感:你永远不知道自动生成的迁移会不会在某个字段上做危险操作,不知道某个 find 调用会在哪个关联上触发射穿数据库的懒查询,也不知道升级一个小版本会不会带来行为变化。相比之下,Prisma 和 Drizzle 都更清楚地在告诉你“哪些事我替你做,哪些事不归我管”。TypeORM 想做的太多,反而在很多不那么顯眼的地方留下了需要你兜底的空间。
所以选型时我很少再问“哪个 ORM 最强”,而是先问:团队最有把握兜住哪类问题? 我身边最成功的 TypeORM 项目,并不是因为它比 Prisma 好用,而是项目负责人把同步建表关掉、把每个迁移文件都人肉 review、把事务写法明文写进规范。一个愿意踩住刹车、认清边界的团队,比任何 ORM 本身的优劣都更能决定项目能走多远。
