罗罗编程学习记录
本页内容 展开查看

06.5.5.3 注解与 AOP 代理

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.5 Hyperf

06.5.5.3-001 Hyperf 中的注解是如何被收集和使用的?

一句话结论

注解是写在类、属性、方法上的元数据;框架在启动扫描期解析注解并分发给对应处理器,路由、注入、切面、消费者等能力都靠注解元数据驱动。

概念解释

PHP 8 原生 Attributes 与框架兼容的 PHPDoc 注解写法都可被识别。注解本身不执行逻辑,真正行为由扫描期注册的处理器或切面在运行期落地。

原理流程

  1. 扫描器遍历注册路径下的类文件。
  2. 解析类、属性、方法上的注解并记录元数据。
  3. 按注解类型分发:路由注解进路由表,注入注解进注入计划,切面注解进切面注册表。
  4. 运行期容器与代理按元数据完成织入。

代码或图示

#[Controller(prefix: 'order')]
class OrderController
{
    #[PostMapping(path: 'create')]
    public function create(): array
    {
        return ['ok' => true];
    }
}

常见误区

  • 以为注解在每次调用时动态解析:多数注解在启动扫描期定型,改动后需重启或清缓存。
  • 注解类未被扫描路径覆盖:自定义注解所在目录也要纳入扫描,否则处理器识别不到。

追问

  • 注解处理器在哪里注册?答:由对应组件在启动期注册;自定义注解通常配合切面按注解类型切入,不写独立处理器也能生效。
  • 2.x 与 3.x 注解写法差异?答:3.x 推荐 PHP 8 属性写法,部分旧文档仍用 @Annotation PHPDoc 形式;以当前版本兼容说明为准(待确认)。

06.5.5.3-002 如何定义一个自定义注解?

一句话结论

自定义注解是一个带 #[Attribute] 声明的 PHP 类,可声明属性参数;再通过切面的 $annotations 规则拦截使用了该注解的类或方法。

概念解释

注解类只承载参数数据,不含业务逻辑;拦截逻辑写在切面里。注解可限定作用目标(类、方法、属性),通过 Attribute::TARGET_* 常量声明。

原理流程

  1. 新建注解类,标注 #[Attribute(Attribute::TARGET_METHOD)]。
  2. 定义构造参数供使用方填写。
  3. 在目标类/方法上使用该注解。
  4. 切面按注解类型匹配并执行增强逻辑。

代码或图示

#[Attribute(Attribute::TARGET_METHOD)]
class LogTrace
{
    public function __construct(public string $scene = 'default')
    {
    }
}

常见误区

  • 在注解类构造函数里写业务逻辑:注解应是纯数据载体,逻辑放切面。
  • 不声明 TARGET 范围:注解可能被用在不期望的位置,校验缺失。

追问

  • 注解参数怎么在切面里读取?答:通过 ProceedingJoinPoint 拿到方法/类上的注解实例,读取其属性;具体获取 API 以版本实现为准(待确认)。
  • 自定义注解需要注册到配置吗?答:扫描自动收集即可;部分组件的注解转换配置可能需要显式登记(待确认:核对 annotations.php 的 convert 配置)。

06.5.5.3-003 AOP 在 Hyperf 中解决什么问题?

一句话结论

AOP 把日志、计时、事务、权限、缓存等横切逻辑从业务方法中剥离,通过切面统一织入,业务代码只保留核心职责,增强逻辑可插拔、可复用。

概念解释

横切关注点分散在多个类的多个方法里,复制粘贴会导致不一致。AOP 在不修改原类代码的前提下,由代理在方法调用前后插入统一处理。

原理流程

  1. 识别跨多个模块重复出现的增强需求(如调用日志)。
  2. 编写切面类声明切入规则与增强逻辑。
  3. 框架为命中类生成代理,方法调用经过代理链。
  4. 业务方法保持纯净,切面可独立开关与调整。

代码或图示

// 业务方法(下单、支付、退款)
// → 统一切面:记录入参、耗时、异常
// → 业务核心逻辑
// → 切面汇总结果并返回

常见误区

  • 用 AOP 替代业务分层:领域规则仍应在服务层,切面只做通用增强。
  • 切面堆积过多职责:一个切面只负责一类横切逻辑,便于维护与排序。

追问

  • AOP 与中间件分工?答:中间件作用于 HTTP/RPC 请求链路;AOP 作用于容器内类方法粒度,可覆盖服务、模型等任意层。
  • 切面能替代单元测试吗?答:不能,切面是运行期增强,业务逻辑仍需独立测试覆盖。

06.5.5.3-004 切面类的基本结构是什么?

一句话结论

切面类继承 Hyperf\Di\Aop\AbstractAspect,用 #[Aspect] 注解或 aspects.php 注册,通过 $classes/$annotations 声明切入规则,实现 process() 方法编写环绕逻辑。

概念解释

AbstractAspect 约定了切面接口;process() 接收 ProceedingJoinPoint,调用其 process() 转发到原方法。切面本身由容器管理,可注入其他依赖。

原理流程

  1. 类继承 AbstractAspect 并标注 #[Aspect]。
  2. 填写 $classes 或 $annotations 切入规则。
  3. 实现 process(ProceedingJoinPoint $joinPoint)。
  4. 在方法内编排前置、转发、后置与异常处理。

代码或图示

use Hyperf\Di\Annotation\Aspect;
use Hyperf\Di\Aop\AbstractAspect;
use Hyperf\Di\Aop\ProceedingJoinPoint;

#[Aspect]
class LogAspect extends AbstractAspect
{
    public array $classes = [
        \App\Service\OrderService::class,
    ];

    public function process(ProceedingJoinPoint $proceedingJoinPoint)
    {
        $start = microtime(true);
        $result = $proceedingJoinPoint->process();
        $cost = microtime(true) - $start;
        return $result;
    }
}

常见误区

  • 切面类不继承 AbstractAspect:框架无法识别为合法切面,规则不生效。
  • 忘记调用 process():原方法不执行,返回结果为空。

追问

  • 切面可以注入服务吗?答:可以,切面由容器创建,支持构造函数与属性注入;但注意切面自身不能被其他切面切入。
  • #[Aspect] 与配置注册二选一吗?答:注解标注或在 config/autoload/aspects.php 登记均可,重复注册需避免(待确认:当前版本去重行为)。

06.5.5.3-005 $classes 切入规则支持哪些写法?

一句话结论

$classes 支持完整类名、类名::方法名 精确方法、命名空间通配符与方法名通配符;按规则匹配目标类或方法生成代理。

概念解释

规则从类粒度到方法粒度逐级收窄:整类切入影响所有方法,::method 只切指定方法,* 做模糊匹配。通配范围越大,被代理类越多,启动与内存成本越高。

原理流程

  1. 启动期把规则解析为匹配模式。
  2. 扫描每个候选类,判断类名是否匹配。
  3. 方法级规则进一步匹配方法名。
  4. 命中的类进入代理生成清单。

代码或图示

public array $classes = [
    \App\Service\UserService::class,                 // 整个类
    \App\Service\OrderService::class . '::create',   // 指定方法
    'App\Service\*::*',                              // 命名空间下所有类方法
];

常见误区

  • 通配符写得过宽(如 App\*):大量无关类被代理,启动变慢、内存上涨。
  • 类名字符串拼错:规则静默不命中,切面看起来“没生效”。

追问

  • 方法名通配怎么写?答:在类后用 :: 连接方法模式,如 ::*Refund;具体通配语法以框架匹配实现为准(待确认)。
  • 规则支持排除吗?答:按官方规则语法确认是否支持取反;不支持时用更精确的类/方法规则收窄范围。

06.5.5.3-006 $annotations 按注解切入怎么用?

一句话结论

$annotations 填写注解类名数组,框架拦截使用了该注解的类或方法;适合用自定义注解作为“开关标记”,切面与目标通过注解解耦。

概念解释

按注解切入比按类名切入更灵活:新增方法只要标注注解即被增强,无需修改切面规则。注解可携带参数,供切面读取差异化配置。

原理流程

  1. 定义自定义注解类。
  2. 切面 $annotations 登记该注解类。
  3. 目标方法/类标注注解。
  4. 扫描期匹配注解使用点,生成对应代理。

代码或图示

public array $annotations = [
    \App\Annotation\LogTrace::class,
];

public function process(ProceedingJoinPoint $proceedingJoinPoint)
{
    // 读取注解参数后执行日志增强
    return $proceedingJoinPoint->process();
}

常见误区

  • 注解只标在类上却期待方法级切入:需确认注解作用目标与切面匹配层级一致。
  • 同一注解既被路由处理器使用又被切面使用:二者互不冲突,但要理清各自消费点。

追问

  • 按注解切入能拿到注解参数吗?答:可以从连接点获取被标注的注解实例;获取方式以版本 API 为准(待确认)。
  • 框架内置注解能作为切入标记吗?答:理论上可匹配内置注解类型,但建议优先用业务自定义注解,避免耦合框架内部。

06.5.5.3-007 Hyperf 有哪几种通知类型?

一句话结论

Hyperf 的 AOP 只提供环绕(Around)一种通用形式;前置、后置、异常处理都在 Around 方法内围绕 process() 调用组织,不再单独提供 Before/After 注解式通知。

概念解释

环绕通知包裹原方法执行:前置逻辑在 process() 之前,后置逻辑在其后,异常用 try/catch 捕获。单一通知形式降低了切面模型复杂度,表达能力并不缺失。

原理流程

  1. 切面 process() 内先写前置逻辑(参数校验、计时起点)。
  2. try 调用 $joinPoint->process() 执行原方法。
  3. 成功:写后置逻辑并返回结果。
  4. 失败:catch 记录异常,补充处理后重新抛出或包装。

代码或图示

public function process(ProceedingJoinPoint $proceedingJoinPoint)
{
    // 前置
    $start = microtime(true);
    try {
        $result = $proceedingJoinPoint->process();
        // 后置成功
        return $result;
    } catch (\Throwable $e) {
        // 异常分支
        throw $e;
    } finally {
        // 收尾:耗时统计
    }
}

常见误区

  • 寻找 #[Before]/#[After] 注解:Hyperf 没有独立通知注解,全部在 Around 内编排。
  • 异常被切面吞掉不抛出:上层与调用方无法感知失败,必须明确重抛或按约定包装。

追问

  • 切面能修改返回值吗?答:可以,process() 之后返回新的值即可;修改入参受代理转发限制,process() 不接受参数(待确认:核对当前版本连接点 API)。
  • finally 里适合做什么?答:计时上报、资源清理等无论成败都要执行的收尾动作。

06.5.5.3-008 ProceedingJoinPoint 提供哪些上下文信息?

一句话结论

连接点对象携带当前类名、方法名、调用参数、目标对象等信息,并提供 process() 转发原方法;切面据此记录日志、判断场景与定制行为。

概念解释

连接点是“切面在何处切入”的运行期描述。不同版本暴露的属性名可能有差异,使用前对照当前版本源码或文档确认;核心信息包括目标类、方法与参数列表。

原理流程

  1. 代理调用切面时构造连接点,填充目标类/方法/参数。
  2. 切面读取连接点信息做判断与记录。
  3. 调用 process() 把参数转发给原方法。
  4. 原方法返回值经连接点回到切面。

代码或图示

public function process(ProceedingJoinPoint $proceedingJoinPoint)
{
    $class = $proceedingJoinPoint->className;
    $method = $proceedingJoinPoint->methodName;
    $arguments = $proceedingJoinPoint->arguments;

    return $proceedingJoinPoint->process();
}

常见误区

  • 直接在连接点上修改 arguments 期待原方法收到新值:参数固化在调用链中,修改不一定生效,需以版本行为为准(待确认)。
  • 把连接点对象保存到成员变量异步使用:连接点属于本次调用,协程结束后不可持有。

追问

  • 如何获取被调用方法的注解?答:通过连接点结合反射读取方法/类注解;具体辅助方法名以版本实现为准(待确认)。
  • target 属性是什么?答:指向被代理的原始目标对象;切面内访问其公开方法需注意再次经过代理的层级(待确认)。

06.5.5.3-009 多个切面的执行顺序如何控制?

一句话结论

多个切面命中同一方法时按切面顺序形成嵌套代理链;顺序由注册顺序或切面优先级决定,具体排序机制与优先级配置以当前版本实现为准,跨切面依赖时必须显式确认顺序。

概念解释

切面链类似中间件洋葱:外层切面的前置先执行、后置后返回。事务切面通常应在日志切面外层,保证日志覆盖事务提交/回滚全过程。

原理流程

  1. 启动期收集所有命中同一方法的切面。
  2. 按排序规则(注册顺序/优先级)排列成链。
  3. 代理按链顺序包裹:外层前置 → 内层前置 → 原方法 → 内层后置 → 外层后置。
  4. 异常沿链反向传递。

代码或图示

// 事务切面(外层)
// → 日志切面(内层)
// → 原方法
// → 日志后置
// 事务提交/回滚

常见误区

  • 假设切面按类名或文件名排序:实际顺序取决于注册与优先级机制,不能靠命名猜。
  • 关键跨切面顺序未验证:事务、鉴权、缓存嵌套错误会导致行为异常。

追问

  • 优先级怎么声明?答:部分版本切面可定义优先级属性;字段名与默认值待确认,需核对 AbstractAspect 与切面注册源码。
  • 顺序有问题怎么调试?答:在各切面前后打印带顺序标记的日志,复现一次调用确认嵌套关系。

06.5.5.3-010 代理类是如何生成和缓存的?

一句话结论

启动扫描期为命中切面规则的类生成代理类代码,写入 runtime/container/proxy/ 缓存目录;容器解析时返回代理实例,代理内部调用切面链后再转发原方法。

概念解释

代理类是框架在编译期(启动期)生成的中间产物,不是手写代码。缓存命中时跳过代码生成,加快二次启动;代理类与业务代码版本不一致时需要清理重建。

原理流程

  1. 切面规则与候选类匹配,确定代理清单。
  2. 为每个命中类生成继承/包装形式的代理代码。
  3. 代理代码落盘到代理缓存目录。
  4. 容器加载代理类,方法调用经代理织入切面。

代码或图示

// runtime/container/proxy/
// ├── App_Service_OrderService.proxy.php   # 代理类缓存(文件名形态以版本为准)
// └── ...

常见误区

  • 手工编辑 runtime/ 下代理文件:重新生成后改动被覆盖。
  • 代码更新后不重建代理:旧代理缺少新方法/新注入,报未初始化或方法不存在。

追问

  • 代理缓存开关是什么?答:与扫描缓存相关的 scan_cacheable 配置项控制是否复用缓存;字段位置与默认值待确认,核对 config/config.php。
  • 生产环境代理放哪里?答:随 runtime/ 目录部署或在构建阶段生成;需保证目录可写或预热完成后只读挂载。

06.5.5.3-011 切面不生效时的排查清单是什么?

一句话结论

按“类是否由容器创建 → 规则是否命中 → 切面是否注册 → 代理是否生成 → 缓存是否过期”逐项排查,多数不生效源于 new 创建、规则拼写错误或旧代理缓存。

概念解释

切面织入依赖容器代理路径;规则不命中则不生成代理;注册缺失则切面不进入链;缓存陈旧则代理仍是旧版本。排查从调用路径向上回溯。

原理流程

  1. 确认目标类通过容器解析,而非 new 直接创建。
  2. 检查 $classes/$annotations 规则拼写与命名空间是否正确。
  3. 确认切面有 #[Aspect] 或在 aspects.php 注册。
  4. 清理代理缓存重启,查看代理目录是否生成对应类。

代码或图示

// # 清理运行期缓存后重启(具体清理脚本以项目为准)
// php bin/hyperf.php

常见误区

  • 只重启不清代理缓存:旧代理继续被加载,新切面挂不上。
  • 在 new 出来的对象上验证切面:该路径没有代理,必然不生效。

追问

  • 怎么确认规则命中?答:在切面 process() 入口加临时日志;未进入说明规则或代理环节有问题。
  • 切面自身被切入会怎样?答:实现 AOP 功能的基础类与切面自身不能被其他切面切入,属于框架限制。

06.5.5.3-012 切面中如何修改方法返回值?

一句话结论

在 process() 执行后对返回结果加工并 return 新值即可,代理把切面返回值作为最终结果;这是结果缓存、结果包装、脱敏等增强的常用手段。

概念解释

返回值修改发生在原方法之后,不影响原方法内部逻辑。典型场景:统一包装响应结构、缓存命中直接返回缓存对象、对敏感字段脱敏。

原理流程

  1. 调用 $joinPoint->process() 取得原结果。
  2. 判断是否需要加工(缓存命中、字段过滤等)。
  3. 返回加工后的值或缓存值。
  4. 切面返回值成为代理调用方拿到的结果。

代码或图示

public function process(ProceedingJoinPoint $proceedingJoinPoint)
{
    $cacheKey = $proceedingJoinPoint->methodName . ':' . json_encode($proceedingJoinPoint->arguments);
    $cached = $this->redis->get($cacheKey);
    if ($cached !== false) {
        return unserialize($cached);
    }
    $result = $proceedingJoinPoint->process();
    return $result;
}

常见误区

  • 缓存切面在事务未提交前写缓存:可能读到未提交数据,缓存时机要与事务边界配合。
  • 修改返回值后类型与接口声明不一致:调用方反序列化或类型断言失败,需保持返回类型兼容。

追问

  • 能短路不执行原方法吗?答:可以,切面直接返回对象,不调用 process();但要记录跳过原因,避免静默丢失业务执行。
  • 返回值加工能复用框架响应包装吗?答:服务层切面返回业务数据即可,HTTP 响应包装由控制器/响应层完成,职责不要混。

06.5.5.3-013 注解与切面如何配合实现声明式增强?

一句话结论

自定义注解作为方法级标记,切面按注解类型切入并读取注解参数,业务方法只需标注注解即可获得增强,实现“声明式”日志、缓存、重试等能力。

概念解释

注解携带场景参数(超时时间、缓存 TTL、日志级别),切面统一消费。新增增强点不改切面代码,只在方法上加注解,符合开闭原则。

原理流程

  1. 设计注解参数(场景、TTL、开关等)。
  2. 切面 $annotations 匹配注解类。
  3. 切面从连接点读取注解实例与参数。
  4. 按参数执行差异化增强逻辑。

代码或图示

#[Attribute(Attribute::TARGET_METHOD)]
class Cacheable
{
    public function __construct(public int $ttl = 60)
    {
    }
}

// 使用处
#[Cacheable(ttl: 120)]
public function detail(int $id): array
{
    return $this->repository->find($id);
}

常见误区

  • 注解参数与切面读取字段名不一致:参数传了但切面用默认值,行为不符预期。
  • 把复杂分支写进注解参数:注解保持简单配置,复杂策略放切面或服务。

追问

  • 内置缓存注解与自研切面怎么选?答:框架组件提供 #[Cacheable] 类注解(具体命名空间待确认);满足需求优先用组件,特殊规则再自研。
  • 注解能继承吗?答:PHP 属性不参与类继承转发,父类方法上的注解是否被子类继承读取需按反射规则确认(待确认)。

06.5.5.3-014 AOP 会带来哪些性能开销?

一句话结论

开销来自启动期代理生成、运行期代理转发与切面逻辑本身;被代理类越多、切面链越长,单次调用的间接层越多,需要按业务价值控制切面范围。

概念解释

启动期成本:扫描规则与生成代理代码;运行期成本:每次方法调用经过代理与切面链。切面内的 IO(日志、缓存、RPC)才是主要耗时,代理转发本身开销相对有限。

原理流程

  1. 评估切面覆盖范围:整类通配 vs 精确方法。
  2. 测量启动耗时与代理类数量。
  3. 压测对比有无切面的单次响应耗时。
  4. 剔除低价值切面,收窄规则范围。

代码或图示

// 优先精确方法规则,避免整命名空间通配
public array $classes = [
    \App\Service\OrderService::class . '::create',
    \App\Service\OrderService::class . '::refund',
];

常见误区

  • 把 AOP 当成性能问题唯一根因:先区分是代理转发开销还是切面内 IO 阻塞。
  • 为“可能用到”的增强预埋切面:未使用的切面也会增加代理面。

追问

  • 日志切面怎么做异步化?答:切面内只组装上下文并投递到异步队列/协程,不阻塞主流程;具体队列组件按项目选型。
  • 生产如何查看代理类数量?答:统计代理缓存目录文件数,结合启动日志评估扫描范围(待确认:是否有官方指标命令)。

06.5.5.3-015 哪些类不能被 AOP 切入?

一句话结论

启动期用于实现 AOP 与容器基础设施的类、切面自身、以及未经过容器创建的 new 对象,不在可切入范围内;框架基础类被切入会破坏代理生成流程。

概念解释

代理生成依赖容器与注解收集机制本身,递归切入基础设施会形成无法解析的闭环。业务类只要由容器创建且规则命中,即可被代理。

原理流程

  1. 框架标记 AOP 基础设施类为不可切入。
  2. 切面类自身排除在切入清单外。
  3. new 创建的对象不经过容器代理路径。
  4. 其余容器解析类按规则生成代理。

代码或图示

// 正确:容器解析,可被代理
$service = $container->get(OrderService::class);

// 错误:绕过容器,切面不生效
$service = new OrderService();

常见误区

  • 尝试给框架核心类加切面排查问题:应通过事件、中间件或扩展点介入,不要切入基础设施。
  • 测试代码里 new 业务类期待切面:单测通常不启动 AOP 容器,切面行为需单独集成测试。

追问

  • 模型类能被切入吗?答:由容器/模型工厂解析的模型可被规则命中;具体模型实例化路径需结合 ORM 组件确认(待确认)。
  • 闭包/箭头函数能切入吗?答:AOP 作用于类方法粒度,闭包不在代理范围内。

06.5.5.3-016 config/autoload/aspects.php 如何注册切面?

一句话结论

该配置文件返回切面类名数组,启动期注册到切面注册表;与 #[Aspect] 注解方式等效,适合集中管理切面清单或按环境开关切面。

概念解释

配置注册把切面清单从代码注解中抽离,便于在不同环境启停切面。数组项为切面类的 ::class,顺序影响切面链排列(顺序机制见 009 题)。

原理流程

  1. 在 aspects.php 返回切面类名数组。
  2. 启动期读取配置并注册到容器切面表。
  3. 切面规则与目标类匹配后生成代理。
  4. 移除数组项即关闭对应切面。

代码或图示

// config/autoload/aspects.php
return [
    \App\Aspect\LogAspect::class,
    \App\Aspect\TransactionAspect::class,
];

常见误区

  • 同一切面既注解又配置重复登记:可能造成链中重复执行,需按版本去重行为确认(待确认)。
  • 配置类名写错命名空间:注册时类不存在,启动或解析阶段报错。

追问

  • 能按环境条件注册切面吗?答:配置文件内可读取环境变量返回不同数组;条件切面还可结合容器定义实现(待确认)。
  • 切面开关关闭后代理还生成吗?答:未注册切面不进入规则匹配,对应类不再为该切面生成代理;缓存需一并清理。

06.5.5.3-017 切面与 Spring AOP、Laravel 中间件如何对照?

一句话结论

三者都是横切增强机制:Hyperf AOP 与 Spring AOP 同属类方法级代理,Hyperf 中间件与 Laravel 中间件同属请求链路级管道;粒度与作用位置不同,不能互相替代。

概念解释

方法级切面覆盖服务、模型等任意层;请求级中间件只在入口链路生效。理解对照有助于跨框架迁移知识,但 API 与代理实现各不相同。

原理流程

  1. 识别增强发生在请求层还是方法层。
  2. 请求鉴权、CORS、日志链路走中间件。
  3. 服务方法事务、计时、缓存走切面。
  4. 跨框架迁移时按粒度映射机制,不照搬注解名。

代码或图示

// 请求链路:中间件(认证、CORS、访问日志)
// 方法链路:AOP 切面(事务、计时、结果缓存、异常包装)

常见误区

  • 把所有增强都堆到中间件:服务内部方法调用不经过入口中间件。
  • 在切面里做 HTTP 层响应改写:切面返回业务数据,响应格式由 Web 层处理。

追问

  • Spring 有 JDK 动态代理与 CGLIB,Hyperf 代理是什么形式?答:Hyperf 由框架生成代理类代码,具体继承/组合形式以代理源码为准(待确认)。
  • Laravel 也有切面式包吗?答:Laravel 主要通过中间件、事件、服务提供者与第三方包实现横切;方法级代理不是其主干机制。

06.5.5.3-018 切面内如何记录方法入参与异常?

一句话结论

从连接点读取类名、方法名、参数列表,在前置或后置阶段组装日志;异常在 catch 中记录类型、消息与调用位置后重抛,避免泄漏敏感参数。

概念解释

日志切面要控制信息量:完整参数可能含密码、身份证等敏感数据,需做字段过滤;异常记录应包含堆栈摘要,但不阻断上层异常处理。

原理流程

  1. 连接点取得 className、methodName、arguments。
  2. 按脱敏规则过滤参数后组装日志上下文。
  3. try 执行原方法,成功记录耗时。
  4. catch 记录异常信息,重抛给上层处理。

代码或图示

public function process(ProceedingJoinPoint $proceedingJoinPoint)
{
    $context = [
        'class' => $proceedingJoinPoint->className,
        'method' => $proceedingJoinPoint->methodName,
        'args' => $this->mask($proceedingJoinPoint->arguments),
    ];
    try {
        return $proceedingJoinPoint->process();
    } catch (\Throwable $e) {
        $this->logger->error('method failed', $context + ['error' => $e->getMessage()]);
        throw $e;
    }
}

常见误区

  • 直接打印全量参数:敏感信息进入日志,违反数据保护要求。
  • 异常记录后不重抛:调用方以为执行成功,事务与补偿流程失效。

追问

  • 大参数怎么处理?答:截断超长字段,对象只记录类型与标识,不序列化整个大对象。
  • 日志在协程间如何区分?答:结合协程上下文的追踪 ID 串联同一次请求的切面日志。

06.5.5.3-019 代理类与原始类的类型关系是什么?

一句话结论

代理类围绕原始类生成,通常保持与原类兼容的类型外观,使容器注入与 instanceof 可用;具体是继承原类还是实现接口包装,以当前版本代理实现为准。

概念解释

保持类型兼容是代理能替代原对象注入容器的前提。但代理内部增加了切面转发层,反射读取属性、判断父类时需要留意代理结构与原始类的差异。

原理流程

  1. 框架分析目标类的继承与接口实现。
  2. 生成保持类型兼容的代理代码。
  3. 代理持有或继承目标,方法调用先过切面链。
  4. 注入与类型判断按兼容外观工作。

代码或图示

// 容器返回的代理在类型上可赋值给原类型
$service = $container->get(UserService::class);
self::assertInstanceOf(UserService::class, $service);

常见误区

  • 反射枚举代理类私有属性来读取业务状态:代理层可能新增属性,应通过公开方法访问。
  • 假设代理 === 原始类实例:代理是包装/子类对象,引用不等同。

追问

  • 注入接口时代理如何兼容?答:代理实现目标接口,容器按接口类型注入;接口绑定仍需在 DI 配置中完成。
  • 代理类文件能反推原类吗?答:代理命名通常包含原类标识,可结合目录与类名核对(命名规则待确认)。

06.5.5.3-020 自研切面时如何做好边界与可维护性?

一句话结论

单一切面只负责一类横切职责,规则精确到必要的类/方法,参数通过注解显式传入;切面内不写领域规则,异常明确重抛,配套日志与测试保证可维护。

概念解释

AOP 是把双刃剑:滥用会让业务行为分散到多个切面中难以追踪。边界清晰的切面可独立开关、独立测试,出问题时能快速定位是业务还是增强层。

原理流程

  1. 确认增强属于横切关注点,而非业务规则。
  2. 定义注解参数与切面职责,编写精确切入规则。
  3. 切面内完成校验、记录、转发、异常处理。
  4. 为切面编写集成测试,覆盖成功、异常与短路分支。

代码或图示

// 职责单一:计时上报切面,不掺杂业务判断
class TimerAspect extends AbstractAspect
{
    public array $classes = [\App\Service\OrderService::class];

    public function process(ProceedingJoinPoint $joinPoint)
    {
        $start = microtime(true);
        try {
            return $joinPoint->process();
        } finally {
            $this->metric->timer($joinPoint->methodName, microtime(true) - $start);
        }
    }
}

常见误区

  • 切面里写业务校验分支:规则变化时要改切面,业务可读性下降。
  • 切面无测试直接上线:横切逻辑影响所有命中方法,回归面大。

追问

  • 多个相似切面如何复用?答:抽取公共连接点解析、脱敏、计时辅助类,各切面组合复用。
  • 如何评估一个增强该不该用 AOP?答:只在多处重复且与核心业务无关时抽切面;单点逻辑留在服务内更直接。