1 / 4概念
AOP
Rust 没有 Spring 式的运行期代理、注解扫描与字节码织入。横切逻辑必须显式落到类型上:用 trait 定义被包装的行为,用泛型或 dyn 包装器插入前后逻辑,用宏消除重复实现,用 tower::Layer 组合中间件栈。判断标准不是“抽象得像不像切面”,而是调用顺序是否可验证、开销是否可解释。
1 概念
1.1 一句话定义
AOP 在 Rust 中是编译期的显式装饰:包装器持有内层实现并实现同一 trait,在调用前后插入日志、计时、重试、鉴权等逻辑;包装在编译期展开,没有运行时切点匹配。
1.2 它解决什么问题
- 日志、指标、重试、超时散落在业务函数里,改一处要动几十处。
- 注解式框架的隐式行为难以调试,出问题看不到调用链。
- 手写包装重复且容易漏掉某个实现。
- 中间件顺序、错误透传与背压缺少统一约束。
- 泛型包装零运行时开销,但副本数量与编译时间需要管理。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| trait、泛型与单态化语义 | OOP |
| 宏语法与关键字 | Syntax |
| 错误类型设计与上下文 | Error |
Future、取消与 Send 约束 | Async |
| HTTP 路由、提取器与框架配置 | 框架章节 |
| 追踪后端与采样策略 | 可观测性章节 |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| 横切关注点 | 多个模块都要处理的逻辑 | 不是业务主流程 |
| 织入 | 把切面插入目标代码 | Rust 只在编译期发生 |
| 代理 | 运行期生成的转发对象 | Rust 没有运行时代理 |
| 装饰器 | 持有内层并增强行为 | 不是注解 |
| 泛型包装 | 对每个内层类型单态化 | 副本随类型数增长 |
dyn 包装 | 用 trait 对象抹掉具体类型 | 一次间接调用 |
Layer | 把内层 Service 包成新 Service | 不是运行期插件 |
poll_ready | 背压与就绪检查 | 不参与业务逻辑 |
| 单态化 | 按具体类型生成代码 | 编译期成本 |
| 属性宏 | 用 #[...] 改写条目 | 不是运行期反射 |
2 机制
2.1 心智模型
把调用链想成一颗洋葱:请求从外向内穿过每一层,响应从内向外返回。Rust 用类型把洋葱的形状固定下来——Layer 把内层 Service 包成新的 Service,嵌套关系在编译期确定,运行时只是普通的嵌套调用。没有“匹配切点”这一步,也就没有运行期织入。
2.2 机制拆解
- 没有运行期织入:Rust 无反射、无字节码;
#[derive]在编译期生成 impl,属性宏在编译期替换条目,二者都不产生运行时代理对象。 - 泛型包装:
struct Logged<S>(S)加impl<S: Service> Service for Logged<S>;编译器为每个S生成一份代码,调用可内联,运行时零开销。 dyn包装:Box<dyn Service>擦除具体类型,一次 vtable 间接跳转;可存放异构中间件栈,但要求 trait 对象安全。- 宏生成实现:
macro_rules!批量生成impl;derive 宏生成 trait 实现;属性宏包裹函数体,如#[instrument]。 - 中间件协议:
tower::Service用poll_ready表达背压、call执行请求;Layer::layer负责包装,ServiceBuilder负责顺序。 - 异步包装:包装器要么实现
Future,要么返回impl Future;跨.await持有引用要求Send,Box::pin每次调用一次堆分配。 - 顺序语义:先加的层在最外层,请求前逻辑正序、响应后逻辑逆序;重试与超时的相对位置决定语义。
- 错误与上下文:包装器不应吞错;转换用
map_err,补充上下文用tracing字段或错误包装。
2.3 完整枚举
Rust 里可用的“切面”手段,按作用时机与成本枚举:
| 手段 | 作用时机 | 分派方式 | 运行时成本 | 适用 | 局限 |
|---|---|---|---|---|---|
| newtype + trait impl | 编译期 | 静态 | 0 | 热路径包装 | 每类型一份副本 |
dyn 包装 | 运行期 | vtable | 1 次间接调用 | 可插拔、异构栈 | 对象安全约束 |
| trait 默认方法 | 编译期 | 静态/动态 | 0 | 提供默认行为 | 不能包裹调用 |
| 高阶函数/闭包 | 编译期 | 静态 | 0 | 单函数装饰 | 组合能力弱 |
macro_rules! | 编译期 | 展开 | 0 | 批量 impl、测试表 | 报错指向展开点 |
| derive 宏 | 编译期 | 生成 impl | 0 | 序列化、错误、构建器 | 只能附加不能替换 |
| 属性宏 | 编译期 | 改写条目 | 0 | 埋点、路由、测试 | 调试与编译成本 |
| 函数式过程宏 | 编译期 | 生成 token | 0 | DSL、SQL 校验 | 学习曲线 |
tower::Layer | 编译期组合 | 静态 | 每层一次调用 | 网络服务中间件 | 生态绑定 |
#[instrument] | 运行期 | span | 每 span 一次记录 | 函数级追踪 | 字段需显式声明 |
| 全局 hook | 运行期 | 回调 | 极低 | panic、分配、日志 | 全局状态 |
build.rs 代码生成 | 构建期 | 生成源码 | 0 | 协议绑定、表驱动 | 增量构建变差 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 泛型包装运行时开销 | 0 | 单态化后可内联 |
dyn 调用 | 1 次间接跳转 | 阻止内联,通常几 ns |
| 包装副本 | 类型数 × 层数 | 10 个类型 × 5 层 = 50 份 |
Box<dyn Trait> 大小 | 2 个指针 | 数据指针 + vtable |
Box::pin | 1 次堆分配 | 异步包装的常见成本 |
| 中间件深度 | 常见 3–8 层 | 再深则排障困难 |
#[instrument] 开销 | 每 span 一次分配 | 高频函数需采样 |
| 编译时间 | 随单态化组合增长 | 用 dyn 断链可缓解 |
3 实践
3.1 最小示例
一个泛型包装器在调用前后计时,再通过 dyn 边界对外暴露,全程没有运行期织入:
use std::time::Instant;
trait Handler {
fn handle(&self, req: &str) -> Result<String, String>;
}
struct Echo;
impl Handler for Echo {
fn handle(&self, req: &str) -> Result<String, String> {
if req.is_empty() {
return Err("empty request".to_owned());
}
Ok(format!("echo: {req}"))
}
}
struct Logged<H>(H);
impl<H: Handler> Handler for Logged<H> {
fn handle(&self, req: &str) -> Result<String, String> {
let start = Instant::now();
let out = self.0.handle(req);
eprintln!("{} ns ok={}", start.elapsed().as_nanos(), out.is_ok());
out
}
}
fn run(handler: &dyn Handler, req: &str) -> String {
handler.handle(req).unwrap_or_else(|e| format!("error: {e}"))
}
fn main() {
let handler: Box<dyn Handler> = Box::new(Logged(Echo));
for req in ["hi", ""] {
println!("{}", run(&*handler, req));
}
}
读法:Logged<Echo> 是 Handler 的包装实现,self.0.handle 就是内层调用,前后各插入一段逻辑;编译器为 Logged<Echo> 生成一份专用代码,run 处再通过 &dyn Handler 擦除类型。Echo 的空请求错误被 unwrap_or_else 转成字符串,包装器本身没有吞错——它把 Result 原样传给调用方。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 泛型包装 | struct W<S>(S); impl<S: Service> Service for W<S> | 零运行时开销 |
dyn 包装 | Box<dyn Service> | 可插拔、异构栈 |
| 组合层 | ServiceBuilder::new().layer(A).layer(B) | 先加的在最外层 |
| 超时 | TimeoutLayer::new(Duration::from_secs(2)) | 放在重试内层更常见 |
| 重试 | RetryLayer + 自定义 Policy | 仅用于幂等操作 |
| 追踪 | TraceLayer、#[instrument(skip(self))] | 字段显式声明 |
| 错误映射 | map_err、MapErrLayer | 不吞错、保留 source |
3.3 标准流程
- 列出横切关注点,并确定请求方向与响应方向的顺序(鉴权 → 追踪 → 限流 → 处理)。
- 定义一个最小 trait:参数用借用,返回
Result,把失败语义写清楚。 - 先写泛型包装器,压测确认没有额外开销;只有需要异构集合时才引入
dyn。 - 用宏生成重复的包装实现,但保持展开结果可读。
- 为包装器写单测:断言内层调用一次、错误原样传递、顺序符合预期,并用
cargo llvm-lines检查单态化成本。
3.4 与相邻技术的组合
- axum / tonic:两者都以
tower::Service为底座,中间件可直接复用。 - tower-http:
TraceLayer、CorsLayer、CompressionLayer、TimeoutLayer组成常见服务栈。 - tracing:
#[instrument]生成 span,OpenTelemetry导出调用链。 - 重试与幂等:
RetryLayer需要业务提供幂等键,不能盲目重试写操作。
3.5 选型维度
| 场景 | 方案 | 运行时成本 | 备注 |
|---|---|---|---|
| 热路径、类型集合固定 | 泛型包装 | 0 | 优先选择 |
| 插件式、运行时可替换 | dyn 包装 | 间接调用 | 注意对象安全 |
| 需要统一协议与背压 | tower::Layer | 每层一次调用 | 生态成熟 |
| 重复声明样板 | macro_rules! | 0 | 展开要可读 |
| 需要读取类型结构 | derive/属性宏 | 0(构建期) | 编译成本 |
| 函数级埋点 | #[instrument] | span 开销 | 高频需采样 |
3.6 决策规则
- 只有出现第三个重复点时才抽象成包装器,避免为单点逻辑造框架。
- 调用链顺序必须能在一处读出来;不要用宏把顺序藏起来。
- 包装器只做横切逻辑,业务分支留在内层。
- 重试放在超时内层、幂等校验外层,避免重试放大超时。
- 热路径禁用
Box::pin与Box<dyn>;需要时先测量再优化。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| 泛型包装 | 零成本、可内联、类型安全 | 单态化膨胀 | 热路径、固定类型集 |
dyn 包装 | 可插拔、异构组合 | 间接调用、对象安全约束 | 插件、配置驱动 |
| 宏生成 | 消除样板、编译期检查 | 报错难读、编译变慢 | 重复 impl、表驱动 |
tower 中间件 | 背压、超时、限流开箱可用 | 绑定 Service 模型 | 网络服务 |
| 业务内联 | 无抽象成本、最直观 | 重复、易漏 | 一次性逻辑 |
3.8 何时不该用
- 逻辑只出现一次,包装器只会增加一层跳转与阅读成本。
- 需要按调用参数动态决定是否织入时,显式
if比宏更清楚。 - 单态化已让编译时间不可接受时,继续加泛型层是负收益。
- 跨服务、跨语言的横切(认证、限流、追踪)应下沉到网关或 sidecar。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 编译时间与体积暴涨 | 泛型层 × 内层类型组合过多 | 抽 dyn 边界、减少层数 |
| 超时后仍在重试 | 重试层包在超时层外面 | 调整 ServiceBuilder 顺序 |
| 错误被吞成默认值 | 包装器 unwrap_or_default | 透传 Result 或显式记录 |
dyn 编译失败 | trait 含泛型方法或返回 Self | 拆分对象安全 trait |
异步包装无法 spawn | 跨 .await 持有非 Send 值 | 缩小锁范围、改 tokio::sync |
包装器要求 'static | 持有借用参数 | 改为拥有数据 |
| 宏报错定位困难 | 展开代码与源码不对应 | cargo expand 对照 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 用宏实现业务分支 | 不可读、不可调试 | 普通函数 + 泛型 |
| 包装器里做重计算 | 每层延迟叠加 | 移到内层或异步任务 |
每层都 clone 大请求体 | 内存与 CPU 浪费 | 借用或 Arc 共享 |
热路径用 Box<dyn> | 失去内联、分配开销 | 泛型 + 枚举分派 |
| 用日志代替指标 | 无法聚合与告警 | 指标 + 采样日志 |
4.3 可观测信号
构建侧:cargo build --timings 的编译热点、cargo llvm-lines 的单态化行数、cargo bloat 的符号体积、cargo expand 的展开结果。运行侧:每层中间件的延迟直方图、层数与顺序快照、错误码分布、span 深度与耗时。测试侧:包装器单测中断言内层调用次数、顺序与错误透传。
4.4 安全 / 性能 / 一致性边界
- 安全:包装器不校验信任边界;日志与 span 字段要脱敏,鉴权不能只靠“外层加了一层”。
- 性能:泛型包装零运行时开销但放大代码体积;
dyn、Box::pin与每层克隆都会累积成尾延迟。 - 一致性:重试要求幂等,超时要与取消语义对齐;包装器顺序改变会改变可观察行为,必须纳入评审。
- 可维护性:宏与深层中间件栈隐藏调用链;团队应约定“顺序只在一处定义”并保留展开样例。