1 / 4概念
AOP
JS 没有编译期的织入。横切逻辑只能靠包装与拦截:装饰器包住类成员,Proxy 拦截对象操作,中间件包住请求,猴子补丁替换函数,插桩钩子在框架层挂钩。判断标准是三件事:作用域多大、顺序怎么排、包装有没有改变原有语义。
1 概念
1.1 一句话定义
AOP 在 JS 里就是「在调用边界插一层包装」:装饰器在类定义时替换成员,Proxy 在运行时拦截对象操作,中间件把请求处理串成链,猴子补丁直接换掉函数引用,插桩钩子由运行时在关键路径上回调。
1.2 它解决什么问题
- 横切逻辑集中:日志、鉴权、缓存、追踪各写一次,而不是散在每个函数里。
- 可组合:装饰器与中间件都能叠加,顺序由组合规则决定,不靠复制粘贴。
- 能覆盖第三方:Proxy 与猴子补丁不改调用方,也能拦到外部对象。
- 可回滚:包装器可以拆掉,比改业务代码更容易恢复。
- 不改业务代码:埋点与追踪能独立上线,减少合并冲突。
代价:隐式控制流、顺序难推理、this 与不变量容易被破坏。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
属性描述符、class 元素、Proxy 的十三个 trap | Objects and Prototypes |
async_hooks 与 diagnostics_channel 的完整 API | Runtime Environment |
| 路由框架与错误中间件的实现 | Frameworks |
| 分布式追踪的上下文传播协议 | Observability |
| 编译期宏与 AST 改写 | Toolchain |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 切面 | 横跨多个模块的公共逻辑 | 不是业务流程的一环 |
| 织入 | 把切面接进调用路径 | 时机决定可观测性 |
| 装饰器 | 类定义时执行的包装函数 | 不是运行时钩子 |
| 描述符 | 值、可写、可枚举、可配置 | 替换方法要保留其余三项 |
| Proxy | 拦截对象内部方法的包装器 | 不是深拷贝,也不改目标 |
| trap | Proxy 的一个拦截方法 | 十三个,对应十三个内部方法 |
| 不变量 | trap 必须与目标一致的条件 | 违反直接抛 TypeError |
| 中间件 | (ctx, next) 组成的处理链 | 只覆盖请求入口 |
| 猴子补丁 | 运行时替换已有函数 | 全局副作用,难回滚 |
| 插桩 | 运行时在关键路径回调 | 平台特定,非标准 |
| 洋葱模型 | 请求由外向内、响应由内向外 | 书写顺序即嵌套顺序 |
2 机制
2.1 心智模型
切面是一层包装,嵌套顺序决定行为。 装饰器在类定义时从上到下求值、从下到上应用;中间件按书写顺序嵌套,第一层在最外;Proxy 的 trap 逐层转发。任何一层改了返回值、异常或 this,业务语义就变了。
2.2 机制拆解
- 标准装饰器(TC39 Stage 3):签名
(value, context) => replacement,返回替换值,返回undefined表示不改。 - 六种 kind:
class、method、getter、setter、field、accessor;field传入undefined,只能用addInitializer挂初始化逻辑。 - 顺序:表达式按书写顺序从上到下求值,应用从下到上;类装饰器在所有成员装饰器之后执行。
- 旧版装饰器:TS 的
experimentalDecorators用(target, key, descriptor),可以直接改描述符;与标准语义不兼容,同一项目不能混用。 - Proxy:
new Proxy(target, handler),get、set、apply、construct最常用于切面,其余 trap 在包装跨界对象时才需要。 - 不变量:不可配置且不可写的属性不能被
get报成别的值,ownKeys必须包含不可配置的自有键,否则引擎抛TypeError。 - 中间件:
(ctx, next)链,await next()之后还能执行收尾;不调next就是短路;忘了await会让错误处理与清理错位。 - 猴子补丁:保存原函数引用再替换;ESM 的命名导入是只读绑定,只能改对象属性(
globalThis.fetch、Array.prototype),不能给导入的标识符重新赋值。 - 插桩:Node 用
diagnostics_channel、async_hooks、PerformanceObserver;自动插桩库靠--require预载或 loader 钩子在加载期替换导出。
2.3 完整枚举
横切手段的八种形态,这是完整集合:
| 手段 | 织入时机 | 作用域 | 可回滚 | 主要代价 |
|---|---|---|---|---|
| 高阶函数包装 | 调用处 | 单个函数 | 是 | 手工组合 |
| 标准装饰器 | 类定义时 | 类与类成员 | 是 | 需转译 |
| 旧版装饰器 | 类定义时 | 类与类成员 | 是 | 与标准不兼容 |
| Proxy | 运行时 | 对象的所有操作 | 是 | 性能与不变量 |
| 中间件 | 请求进入时 | 请求链路 | 是 | 只覆盖入口 |
| 猴子补丁 | 进程启动时 | 全局 | 手工 | 冲突与副作用 |
| 运行时插桩 | 加载或运行时 | 模块与内建 | 部分 | 平台特定 |
| 构建期转换 | 构建时 | 整个产物 | 否 | 工具链复杂 |
装饰器的六种 kind,这是完整集合:
| kind | 传入的 value | 返回值的作用 | 典型用途 |
|---|---|---|---|
class | 类本身 | 替换类 | 注册、混入 |
method | 方法函数 | 替换方法 | 计时、重试、缓存 |
getter | getter 函数 | 替换 getter | 惰性求值与缓存 |
setter | setter 函数 | 替换 setter | 校验与归一化 |
field | undefined | 只能挂 addInitializer | 注入与绑定 |
accessor | get 与 set 对象 | 替换访问器 | 响应式追踪 |
Proxy 的十三个 trap 完整列在 Objects and Prototypes;切面常用的只有 get、set、has、apply、construct、deleteProperty、ownKeys 七个。
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| Proxy trap 数量 | 13 | 对应 13 个内部方法 |
| 装饰器 kind | 6 | 六种 kind 覆盖全部类成员 |
| 装饰器执行次数 | 每个类定义一次 | 不在每次调用时执行 |
| 装饰器应用顺序 | 从下到上 | 写在最上面的处于最外层 |
| 中间件链长度 | 建议不超过 10 层 | 每层一次异步跳转 |
| Proxy 属性读取 | 比普通对象慢一个数量级 | 热路径必须实测 |
async_hooks 开销 | 明显,且不覆盖所有资源 | 生产优先 AsyncLocalStorage |
3 实践
3.1 最小示例
标准装饰器的语义可以手写出来:替换原型上的方法描述符,只换 value,其余三项保留。
function traced(value, context) {
if (context.kind !== 'method') return value;
return function (...args) {
const start = performance.now();
try {
return value.apply(this, args); // 保住调用时的接收者
} finally {
console.log(context.name, (performance.now() - start).toFixed(2));
}
};
}
class Cart {
#items = [];
add(sku) { return this.#items.push(sku); }
}
const descriptor = Object.getOwnPropertyDescriptor(Cart.prototype, 'add');
Object.defineProperty(Cart.prototype, 'add', {
...descriptor,
value: traced(descriptor.value, {kind: 'method', name: 'add'}),
});
console.log(new Cart().add('tea'), Object.keys(Cart.prototype).length);
追踪五步:getOwnPropertyDescriptor 拿到原型上那个不可枚举的方法,展开后只替换 value,writable、enumerable、configurable 原样保留,所以 Object.keys(Cart.prototype) 仍然是 0。包装函数用 function 而不是箭头,value.apply(this, args) 把调用时的接收者传回去;#items 由原方法自己访问,私有字段不经过包装器,因此不会报错。finally 保证计时在异常路径上也会打印,异常继续向外抛。返回的函数 name 与 length 都丢了,转译器会额外补回,需要时可用 Object.defineProperty 设置。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 标准装饰器 | (value, context) => replacement | 返回 undefined 表示不改 |
| 读描述符 | Object.getOwnPropertyDescriptor | 保留可枚举与可配置 |
| 包装方法 | fn.apply(this, args) | 保住 this |
| 建 Proxy | new Proxy(target, handler) | handler 里放 trap |
| 中间件 | (ctx, next) => {} | 不调 next 即短路 |
| 保存原函数 | const original = obj.fn | 回滚与防重复包装 |
| 标记已包装 | obj.fn[Symbol.for('patched')] | 幂等检查 |
| 订阅插桩 | diagnostics_channel.subscribe | 无侵入观测 |
3.3 标准流程
- 先判断切面属于请求级还是任意调用级:请求级用中间件,对象级用 Proxy 或装饰器。
- 写下顺序:哪层最外、哪层最先看到请求、异常在哪层被兜住。
- 保住四样东西:
this、返回值、异常、属性描述符。 - 加开关与采样,包装器自身要能观测:失败不吞、加超时、防递归。
- 单测钉住顺序、
this、异常透传、短路与重复包装。
3.4 与相邻技术的组合
- 依赖注入:装饰器在类定义时声明元数据;标准装饰器没有内置反射,元数据要放
WeakMap或addInitializer。 - 路由与框架:方法装饰器注册 handler,参数装饰器挂校验;旧版语义的框架依赖
reflect-metadata。 - 响应式:Vue 3 用 Proxy 的
get、set、deleteProperty追踪依赖。 - 可观测:OpenTelemetry 用加载期插桩加 span,中间件补业务上下文。
- 构建:Babel 或 SWC 把装饰器转成辅助函数调用。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 织入时机 | 构建期 / 加载期 / 运行期 / 网络期 | 可观测性与回滚难度 |
| 作用域 | 类 / 方法 / 对象 / 请求 / 进程 | 影响面与冲突概率 |
| 是否改原对象 | 包装 / 替换 | 可逆性与调试成本 |
| 性能预算 | 每次调用 / 仅边界 | 热路径能否使用 |
| 可关闭性 | 开关 / 采样 / 常开 | 线上风险 |
3.6 决策规则
- 装饰器从下到上应用,写在最上面的那一层最外。
- 中间件从外到内,错误处理放最外层,收尾放在
next()之后。 - 包装必须
apply(this, args),并原样透传返回值与异常。 - 不改第三方对象的原型;必须改时限定在入口文件并记录。
- Proxy 用
Reflect转发,不谎报属性;热路径不用 Proxy。 - 横切逻辑失败不能改变业务结果:日志失败要吞,鉴权失败必须抛。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 高阶函数 | 零语法,可单测 | 手工组合,无声明式 | 单点包装 |
| 标准装饰器 | 声明式,可叠加 | 需转译,作用域限类 | 类成员切面 |
| Proxy | 拦截所有操作 | 性能与不变量 | 响应式、校验、只读 |
| 中间件 | 顺序清晰,天然短路 | 只覆盖请求入口 | HTTP 与 RPC |
| 猴子补丁 | 不改调用方 | 全局副作用,冲突 | 临时诊断 |
| 构建期转换 | 零运行时开销 | 构建链复杂 | 埋点与 i18n |
3.8 何时不该用
- 不要用装饰器写业务主流程:控制流隐藏,IDE 跳转失效。
- 不要在库代码里猴子补丁全局对象,会污染所有使用者。
- 不要用 Proxy 包高频访问的对象,每个属性都是一次函数调用。
- 不要用 AOP 悄悄改返回值,缓存返回旧值必须显式声明。
- 不要在同一个方法上叠超过三层装饰器,顺序几乎无法推理;装饰器语义受转译目标限制,旧版与标准方案不能混用。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
this 丢失 | 用箭头包装或没 apply | 用 function 加 apply |
Proxy 抛 TypeError | trap 违反不变量 | 用 Reflect 原样转发 |
| 顺序错乱 | 装饰器或中间件顺序反 | 按洋葱模型重排 |
| 补丁被覆盖 | 多处替换同一个函数 | 加标记,收敛到一处 |
| 私有字段报错 | 包装器里直接读 this.#x | 只调用原方法 |
super 不可用 | 包装函数不在类体内 | 用 Reflect.get 取父类方法 |
| 计时重复 | 同一函数被包装两次 | 包装前查标记 |
| 异常被吞 | catch 后没有重抛 | 记录后重抛 |
| getter 变成数据属性 | 覆盖描述符时丢了 get | 保留 get 与 set |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 箭头函数包装方法 | this 变成词法作用域 | function 加 apply |
改 Array.prototype | 全局影响,难回滚 | 用工具函数 |
| 装饰器里做 I/O | 类定义时执行一次且阻塞 | 移到运行时 |
| Proxy 里深拷贝 | 每次读写都复制 | 惰性求值,结构共享 |
中间件不 next 也不结束响应 | 请求挂起 | 显式结束或抛错 |
| 补丁后不保存原函数 | 无法恢复 | 先存引用 |
4.3 可观测信号
包装层耗时占请求总耗时的比例、每秒 trap 调用次数、装饰器层数与中间件链长度、补丁冲突告警数、与 this 相关的 TypeError 计数、插桩采样率与丢弃数、重复包装检测命中次数。
4.4 安全 / 性能 / 一致性边界
- 安全:猴子补丁能被用来劫持调用,是供应链攻击的常见手法;Proxy 不是安全边界,绕过包装直接操作目标即可;日志里的参数要脱敏。
- 性能:Proxy 每次属性访问多一次函数调用;装饰器只在类定义时执行一次,成本可忽略;中间件每请求 O(n)。
- 一致性:替换方法要保留描述符的其余三项,否则枚举、序列化、可配置性都会变;包装要透传返回值与异常;顺序必须固定到可以断言。
- 可维护性:横切逻辑不能改变业务语义,埋点失败不能让请求失败,但鉴权失败必须失败。