06.5.5.3 注解与 AOP 代理
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.5 Hyperf
06.5.5.3-001 Hyperf 中的注解是如何被收集和使用的?
一句话结论
注解是写在类、属性、方法上的元数据;框架在启动扫描期解析注解并分发给对应处理器,路由、注入、切面、消费者等能力都靠注解元数据驱动。
概念解释
PHP 8 原生 Attributes 与框架兼容的 PHPDoc 注解写法都可被识别。注解本身不执行逻辑,真正行为由扫描期注册的处理器或切面在运行期落地。
原理流程
- 扫描器遍历注册路径下的类文件。
- 解析类、属性、方法上的注解并记录元数据。
- 按注解类型分发:路由注解进路由表,注入注解进注入计划,切面注解进切面注册表。
- 运行期容器与代理按元数据完成织入。
代码或图示
#[Controller(prefix: 'order')]
class OrderController
{
#[PostMapping(path: 'create')]
public function create(): array
{
return ['ok' => true];
}
}
常见误区
- 以为注解在每次调用时动态解析:多数注解在启动扫描期定型,改动后需重启或清缓存。
- 注解类未被扫描路径覆盖:自定义注解所在目录也要纳入扫描,否则处理器识别不到。
追问
- 注解处理器在哪里注册?答:由对应组件在启动期注册;自定义注解通常配合切面按注解类型切入,不写独立处理器也能生效。
- 2.x 与 3.x 注解写法差异?答:3.x 推荐 PHP 8 属性写法,部分旧文档仍用
@AnnotationPHPDoc 形式;以当前版本兼容说明为准(待确认)。
06.5.5.3-002 如何定义一个自定义注解?
一句话结论
自定义注解是一个带 #[Attribute] 声明的 PHP 类,可声明属性参数;再通过切面的 $annotations 规则拦截使用了该注解的类或方法。
概念解释
注解类只承载参数数据,不含业务逻辑;拦截逻辑写在切面里。注解可限定作用目标(类、方法、属性),通过 Attribute::TARGET_* 常量声明。
原理流程
- 新建注解类,标注
#[Attribute(Attribute::TARGET_METHOD)]。 - 定义构造参数供使用方填写。
- 在目标类/方法上使用该注解。
- 切面按注解类型匹配并执行增强逻辑。
代码或图示
#[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 在不修改原类代码的前提下,由代理在方法调用前后插入统一处理。
原理流程
- 识别跨多个模块重复出现的增强需求(如调用日志)。
- 编写切面类声明切入规则与增强逻辑。
- 框架为命中类生成代理,方法调用经过代理链。
- 业务方法保持纯净,切面可独立开关与调整。
代码或图示
// 业务方法(下单、支付、退款)
// → 统一切面:记录入参、耗时、异常
// → 业务核心逻辑
// → 切面汇总结果并返回
常见误区
- 用 AOP 替代业务分层:领域规则仍应在服务层,切面只做通用增强。
- 切面堆积过多职责:一个切面只负责一类横切逻辑,便于维护与排序。
追问
- AOP 与中间件分工?答:中间件作用于 HTTP/RPC 请求链路;AOP 作用于容器内类方法粒度,可覆盖服务、模型等任意层。
- 切面能替代单元测试吗?答:不能,切面是运行期增强,业务逻辑仍需独立测试覆盖。
06.5.5.3-004 切面类的基本结构是什么?
一句话结论
切面类继承 Hyperf\Di\Aop\AbstractAspect,用 #[Aspect] 注解或 aspects.php 注册,通过 $classes/$annotations 声明切入规则,实现 process() 方法编写环绕逻辑。
概念解释
AbstractAspect 约定了切面接口;process() 接收 ProceedingJoinPoint,调用其 process() 转发到原方法。切面本身由容器管理,可注入其他依赖。
原理流程
- 类继承
AbstractAspect并标注#[Aspect]。 - 填写
$classes或$annotations切入规则。 - 实现
process(ProceedingJoinPoint $joinPoint)。 - 在方法内编排前置、转发、后置与异常处理。
代码或图示
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 只切指定方法,* 做模糊匹配。通配范围越大,被代理类越多,启动与内存成本越高。
原理流程
- 启动期把规则解析为匹配模式。
- 扫描每个候选类,判断类名是否匹配。
- 方法级规则进一步匹配方法名。
- 命中的类进入代理生成清单。
代码或图示
public array $classes = [
\App\Service\UserService::class, // 整个类
\App\Service\OrderService::class . '::create', // 指定方法
'App\Service\*::*', // 命名空间下所有类方法
];
常见误区
- 通配符写得过宽(如
App\*):大量无关类被代理,启动变慢、内存上涨。 - 类名字符串拼错:规则静默不命中,切面看起来“没生效”。
追问
- 方法名通配怎么写?答:在类后用
::连接方法模式,如::*Refund;具体通配语法以框架匹配实现为准(待确认)。 - 规则支持排除吗?答:按官方规则语法确认是否支持取反;不支持时用更精确的类/方法规则收窄范围。
06.5.5.3-006 $annotations 按注解切入怎么用?
一句话结论
$annotations 填写注解类名数组,框架拦截使用了该注解的类或方法;适合用自定义注解作为“开关标记”,切面与目标通过注解解耦。
概念解释
按注解切入比按类名切入更灵活:新增方法只要标注注解即被增强,无需修改切面规则。注解可携带参数,供切面读取差异化配置。
原理流程
- 定义自定义注解类。
- 切面
$annotations登记该注解类。 - 目标方法/类标注注解。
- 扫描期匹配注解使用点,生成对应代理。
代码或图示
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 捕获。单一通知形式降低了切面模型复杂度,表达能力并不缺失。
原理流程
- 切面
process()内先写前置逻辑(参数校验、计时起点)。 try调用$joinPoint->process()执行原方法。- 成功:写后置逻辑并返回结果。
- 失败:
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() 转发原方法;切面据此记录日志、判断场景与定制行为。
概念解释
连接点是“切面在何处切入”的运行期描述。不同版本暴露的属性名可能有差异,使用前对照当前版本源码或文档确认;核心信息包括目标类、方法与参数列表。
原理流程
- 代理调用切面时构造连接点,填充目标类/方法/参数。
- 切面读取连接点信息做判断与记录。
- 调用
process()把参数转发给原方法。 - 原方法返回值经连接点回到切面。
代码或图示
public function process(ProceedingJoinPoint $proceedingJoinPoint)
{
$class = $proceedingJoinPoint->className;
$method = $proceedingJoinPoint->methodName;
$arguments = $proceedingJoinPoint->arguments;
return $proceedingJoinPoint->process();
}
常见误区
- 直接在连接点上修改
arguments期待原方法收到新值:参数固化在调用链中,修改不一定生效,需以版本行为为准(待确认)。 - 把连接点对象保存到成员变量异步使用:连接点属于本次调用,协程结束后不可持有。
追问
- 如何获取被调用方法的注解?答:通过连接点结合反射读取方法/类注解;具体辅助方法名以版本实现为准(待确认)。
target属性是什么?答:指向被代理的原始目标对象;切面内访问其公开方法需注意再次经过代理的层级(待确认)。
06.5.5.3-009 多个切面的执行顺序如何控制?
一句话结论
多个切面命中同一方法时按切面顺序形成嵌套代理链;顺序由注册顺序或切面优先级决定,具体排序机制与优先级配置以当前版本实现为准,跨切面依赖时必须显式确认顺序。
概念解释
切面链类似中间件洋葱:外层切面的前置先执行、后置后返回。事务切面通常应在日志切面外层,保证日志覆盖事务提交/回滚全过程。
原理流程
- 启动期收集所有命中同一方法的切面。
- 按排序规则(注册顺序/优先级)排列成链。
- 代理按链顺序包裹:外层前置 → 内层前置 → 原方法 → 内层后置 → 外层后置。
- 异常沿链反向传递。
代码或图示
// 事务切面(外层)
// → 日志切面(内层)
// → 原方法
// → 日志后置
// 事务提交/回滚
常见误区
- 假设切面按类名或文件名排序:实际顺序取决于注册与优先级机制,不能靠命名猜。
- 关键跨切面顺序未验证:事务、鉴权、缓存嵌套错误会导致行为异常。
追问
- 优先级怎么声明?答:部分版本切面可定义优先级属性;字段名与默认值待确认,需核对
AbstractAspect与切面注册源码。 - 顺序有问题怎么调试?答:在各切面前后打印带顺序标记的日志,复现一次调用确认嵌套关系。
06.5.5.3-010 代理类是如何生成和缓存的?
一句话结论
启动扫描期为命中切面规则的类生成代理类代码,写入 runtime/container/proxy/ 缓存目录;容器解析时返回代理实例,代理内部调用切面链后再转发原方法。
概念解释
代理类是框架在编译期(启动期)生成的中间产物,不是手写代码。缓存命中时跳过代码生成,加快二次启动;代理类与业务代码版本不一致时需要清理重建。
原理流程
- 切面规则与候选类匹配,确定代理清单。
- 为每个命中类生成继承/包装形式的代理代码。
- 代理代码落盘到代理缓存目录。
- 容器加载代理类,方法调用经代理织入切面。
代码或图示
// runtime/container/proxy/
// ├── App_Service_OrderService.proxy.php # 代理类缓存(文件名形态以版本为准)
// └── ...
常见误区
- 手工编辑
runtime/下代理文件:重新生成后改动被覆盖。 - 代码更新后不重建代理:旧代理缺少新方法/新注入,报未初始化或方法不存在。
追问
- 代理缓存开关是什么?答:与扫描缓存相关的
scan_cacheable配置项控制是否复用缓存;字段位置与默认值待确认,核对config/config.php。 - 生产环境代理放哪里?答:随
runtime/目录部署或在构建阶段生成;需保证目录可写或预热完成后只读挂载。
06.5.5.3-011 切面不生效时的排查清单是什么?
一句话结论
按“类是否由容器创建 → 规则是否命中 → 切面是否注册 → 代理是否生成 → 缓存是否过期”逐项排查,多数不生效源于 new 创建、规则拼写错误或旧代理缓存。
概念解释
切面织入依赖容器代理路径;规则不命中则不生成代理;注册缺失则切面不进入链;缓存陈旧则代理仍是旧版本。排查从调用路径向上回溯。
原理流程
- 确认目标类通过容器解析,而非
new直接创建。 - 检查
$classes/$annotations规则拼写与命名空间是否正确。 - 确认切面有
#[Aspect]或在aspects.php注册。 - 清理代理缓存重启,查看代理目录是否生成对应类。
代码或图示
// # 清理运行期缓存后重启(具体清理脚本以项目为准)
// php bin/hyperf.php
常见误区
- 只重启不清代理缓存:旧代理继续被加载,新切面挂不上。
- 在
new出来的对象上验证切面:该路径没有代理,必然不生效。
追问
- 怎么确认规则命中?答:在切面
process()入口加临时日志;未进入说明规则或代理环节有问题。 - 切面自身被切入会怎样?答:实现 AOP 功能的基础类与切面自身不能被其他切面切入,属于框架限制。
06.5.5.3-012 切面中如何修改方法返回值?
一句话结论
在 process() 执行后对返回结果加工并 return 新值即可,代理把切面返回值作为最终结果;这是结果缓存、结果包装、脱敏等增强的常用手段。
概念解释
返回值修改发生在原方法之后,不影响原方法内部逻辑。典型场景:统一包装响应结构、缓存命中直接返回缓存对象、对敏感字段脱敏。
原理流程
- 调用
$joinPoint->process()取得原结果。 - 判断是否需要加工(缓存命中、字段过滤等)。
- 返回加工后的值或缓存值。
- 切面返回值成为代理调用方拿到的结果。
代码或图示
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、日志级别),切面统一消费。新增增强点不改切面代码,只在方法上加注解,符合开闭原则。
原理流程
- 设计注解参数(场景、TTL、开关等)。
- 切面
$annotations匹配注解类。 - 切面从连接点读取注解实例与参数。
- 按参数执行差异化增强逻辑。
代码或图示
#[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)才是主要耗时,代理转发本身开销相对有限。
原理流程
- 评估切面覆盖范围:整类通配 vs 精确方法。
- 测量启动耗时与代理类数量。
- 压测对比有无切面的单次响应耗时。
- 剔除低价值切面,收窄规则范围。
代码或图示
// 优先精确方法规则,避免整命名空间通配
public array $classes = [
\App\Service\OrderService::class . '::create',
\App\Service\OrderService::class . '::refund',
];
常见误区
- 把 AOP 当成性能问题唯一根因:先区分是代理转发开销还是切面内 IO 阻塞。
- 为“可能用到”的增强预埋切面:未使用的切面也会增加代理面。
追问
- 日志切面怎么做异步化?答:切面内只组装上下文并投递到异步队列/协程,不阻塞主流程;具体队列组件按项目选型。
- 生产如何查看代理类数量?答:统计代理缓存目录文件数,结合启动日志评估扫描范围(待确认:是否有官方指标命令)。
06.5.5.3-015 哪些类不能被 AOP 切入?
一句话结论
启动期用于实现 AOP 与容器基础设施的类、切面自身、以及未经过容器创建的 new 对象,不在可切入范围内;框架基础类被切入会破坏代理生成流程。
概念解释
代理生成依赖容器与注解收集机制本身,递归切入基础设施会形成无法解析的闭环。业务类只要由容器创建且规则命中,即可被代理。
原理流程
- 框架标记 AOP 基础设施类为不可切入。
- 切面类自身排除在切入清单外。
new创建的对象不经过容器代理路径。- 其余容器解析类按规则生成代理。
代码或图示
// 正确:容器解析,可被代理
$service = $container->get(OrderService::class);
// 错误:绕过容器,切面不生效
$service = new OrderService();
常见误区
- 尝试给框架核心类加切面排查问题:应通过事件、中间件或扩展点介入,不要切入基础设施。
- 测试代码里
new业务类期待切面:单测通常不启动 AOP 容器,切面行为需单独集成测试。
追问
- 模型类能被切入吗?答:由容器/模型工厂解析的模型可被规则命中;具体模型实例化路径需结合 ORM 组件确认(待确认)。
- 闭包/箭头函数能切入吗?答:AOP 作用于类方法粒度,闭包不在代理范围内。
06.5.5.3-016 config/autoload/aspects.php 如何注册切面?
一句话结论
该配置文件返回切面类名数组,启动期注册到切面注册表;与 #[Aspect] 注解方式等效,适合集中管理切面清单或按环境开关切面。
概念解释
配置注册把切面清单从代码注解中抽离,便于在不同环境启停切面。数组项为切面类的 ::class,顺序影响切面链排列(顺序机制见 009 题)。
原理流程
- 在
aspects.php返回切面类名数组。 - 启动期读取配置并注册到容器切面表。
- 切面规则与目标类匹配后生成代理。
- 移除数组项即关闭对应切面。
代码或图示
// 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 与代理实现各不相同。
原理流程
- 识别增强发生在请求层还是方法层。
- 请求鉴权、CORS、日志链路走中间件。
- 服务方法事务、计时、缓存走切面。
- 跨框架迁移时按粒度映射机制,不照搬注解名。
代码或图示
// 请求链路:中间件(认证、CORS、访问日志)
// 方法链路:AOP 切面(事务、计时、结果缓存、异常包装)
常见误区
- 把所有增强都堆到中间件:服务内部方法调用不经过入口中间件。
- 在切面里做 HTTP 层响应改写:切面返回业务数据,响应格式由 Web 层处理。
追问
- Spring 有 JDK 动态代理与 CGLIB,Hyperf 代理是什么形式?答:Hyperf 由框架生成代理类代码,具体继承/组合形式以代理源码为准(待确认)。
- Laravel 也有切面式包吗?答:Laravel 主要通过中间件、事件、服务提供者与第三方包实现横切;方法级代理不是其主干机制。
06.5.5.3-018 切面内如何记录方法入参与异常?
一句话结论
从连接点读取类名、方法名、参数列表,在前置或后置阶段组装日志;异常在 catch 中记录类型、消息与调用位置后重抛,避免泄漏敏感参数。
概念解释
日志切面要控制信息量:完整参数可能含密码、身份证等敏感数据,需做字段过滤;异常记录应包含堆栈摘要,但不阻断上层异常处理。
原理流程
- 连接点取得
className、methodName、arguments。 - 按脱敏规则过滤参数后组装日志上下文。
try执行原方法,成功记录耗时。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 可用;具体是继承原类还是实现接口包装,以当前版本代理实现为准。
概念解释
保持类型兼容是代理能替代原对象注入容器的前提。但代理内部增加了切面转发层,反射读取属性、判断父类时需要留意代理结构与原始类的差异。
原理流程
- 框架分析目标类的继承与接口实现。
- 生成保持类型兼容的代理代码。
- 代理持有或继承目标,方法调用先过切面链。
- 注入与类型判断按兼容外观工作。
代码或图示
// 容器返回的代理在类型上可赋值给原类型
$service = $container->get(UserService::class);
self::assertInstanceOf(UserService::class, $service);
常见误区
- 反射枚举代理类私有属性来读取业务状态:代理层可能新增属性,应通过公开方法访问。
- 假设代理
===原始类实例:代理是包装/子类对象,引用不等同。
追问
- 注入接口时代理如何兼容?答:代理实现目标接口,容器按接口类型注入;接口绑定仍需在 DI 配置中完成。
- 代理类文件能反推原类吗?答:代理命名通常包含原类标识,可结合目录与类名核对(命名规则待确认)。
06.5.5.3-020 自研切面时如何做好边界与可维护性?
一句话结论
单一切面只负责一类横切职责,规则精确到必要的类/方法,参数通过注解显式传入;切面内不写领域规则,异常明确重抛,配套日志与测试保证可维护。
概念解释
AOP 是把双刃剑:滥用会让业务行为分散到多个切面中难以追踪。边界清晰的切面可独立开关、独立测试,出问题时能快速定位是业务还是增强层。
原理流程
- 确认增强属于横切关注点,而非业务规则。
- 定义注解参数与切面职责,编写精确切入规则。
- 切面内完成校验、记录、转发、异常处理。
- 为切面编写集成测试,覆盖成功、异常与短路分支。
代码或图示
// 职责单一:计时上报切面,不掺杂业务判断
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?答:只在多处重复且与核心业务无关时抽切面;单点逻辑留在服务内更直接。