meteor-collection-hooks选项体系全解：fetchPrevious与fetchFields的正确姿势-平芜编程栈

meteor-collection-hooks选项体系全解：fetchPrevious与fetchFields的正确姿势

【免费下载链接】meteor-collection-hooksMeteor Collection Hooks项目地址: https://gitcode.com/gh_mirrors/me/meteor-collection-hooks

Meteor 应用中使用meteor-collection-hooks为集合添加钩子时，fetchPrevious与fetchFields是最常用也最容易被忽略的两个选项。本篇文章面向新手与普通用户，用通俗的语言讲清这套选项体系的配置层级、适用场景与常见坑，帮你写出更高效、更安全的集合钩子。

一、选项体系：三处配置，一套逻辑 📦

在开始之前，先认识整个meteor-collection-hooks 选项体系的"三层配置"结构：

配置层级	写法示例	作用范围
全局默认	`CollectionHooks.defaults.after.update`	所有集合的同类钩子
集合级	`MyCollection.hookOptions.after.update`	单个集合的所有钩子
钩子级	`after.update(fn, { fetchPrevious: true })`	单个钩子

💡 三个层级内部还支持按"时机（before/after）"与"方法（insert/update/remove…）"细分，越是具体的位置优先级越高。集合级配置会覆盖全局默认，具体实现可参考 collection-hooks.js 中的extendOptions方法。

这套设计的好处是：写一次配置，全项目生效，不用在每个钩子里重复写选项。

二、fetchPrevious：拿到"更新前"的文档 🕐

fetchPrevious是after.update钩子专属选项，控制是否在更新前预取旧文档，供this.previous使用。

什么时候需要它？

典型场景是对比新旧值：

Orders.after.update(function (userId, doc, fieldNames, modifier, options) { if (this.previous.status !== doc.status) { // 订单状态发生了变化，做额外处理 notifyUser(this.previous.userId, this.previous.status, doc.status); } }, { fetchPrevious: true });

两个必须知道的坑 ⚠️

默认就是开启的：不写选项时，包会自动预取旧文档，this.previous直接可用；
"全员 false"才真正关闭：如果同一个集合上注册了多个after.update钩子，只要有一个没有设置fetchPrevious: false，所有钩子依然会拿到预取的旧文档。

因此官方推荐用集合级配置来统一关闭：

Orders.hookOptions.after.update = { fetchPrevious: false };

什么时候该关闭？

当你的after.update钩子根本不需要旧值（比如只做日志记录、推送通知），关闭预取可以省掉一次文档查询，在高频更新场景下收益明显。

三、fetchFields：按需取字段，性能优化利器 ⚡

如果说fetchPrevious解决的是"要不要取旧文档"，那么fetchFields解决的就是"取哪些字段"——它本质上是 MongoDB 的投影（projection），只把钩子真正用到的字段取出来。

Orders.after.update(function (userId, doc) { // 只用到 _id 和 status，别的字段不关心 archiveOrder(doc._id, doc.status); }, { fetchFields: { _id: 1, status: 1 } });

合并规则：取并集 🔗

当多个钩子各自声明了fetchFields，包会自动合并所有字段，保证每个钩子都能拿到自己需要的字段：

Orders.after.update(fnA, { fetchFields: { status: 1 } }); Orders.after.update(fnB, { fetchFields: { total: 1 } }); // 实际查询会同时带上 status 和 total

组合使用：只取必要字段

fetchPrevious与fetchFields可以组合使用——这样连旧文档也只保留关键字段，进一步降低内存与网络开销（测试用例见 update_local.test.js）：

Orders.after.update(function (userId, doc) { // this.previous 中只有 start_value，没有 other_value }, { fetchPrevious: true, fetchFields: { start_value: true } });

四、正确的姿势：一份检查清单 ✅

场景	推荐配置
需要对比新旧值	`fetchPrevious: true`（默认即可）
钩子不需要旧值	全部钩子设置`fetchPrevious: false`，或用`hookOptions`统一关闭
钩子只用少数字段	设置`fetchFields`，只取必要字段
多个钩子并存	注意`fetchFields`自动合并；`fetchPrevious`需要"全员 false"
想全局统一	用`CollectionHooks.defaults`或`hookOptions`，避免逐钩子配置