应将切面中硬编码的 $classes 和 $annotations 抽成常量，避免重复维护；精确指定拦截目标，禁用泛滥通配符；合并重复拦截的切面，用条件分支分流；确保注解类正确声明作用域并写全路径；修改后清空 runtime/container/proxy 目录。
切面类里反复写 $classes 和 $annotations 怎么办
Hyperf 的切面类必须显式声明拦截目标，$classes 和 $annotations 是硬编码数组，没法自动推导——哪怕你只改一个类名，所有用到它的切面都得同步更新。这不是设计缺陷，而是框架为确定性织入做的取舍。
实操建议：
- 把常用匹配规则抽成常量，比如在
App\Constants\AspectTargets里定义public const USER_SERVICE = 'App\Service\UserService::*'; - 避免用通配符
*滥用，App\Service\*::*会匹配所有方法，容易误伤；优先用UserService::update这种精确写法 - 注解类路径必须写全，
App\Annotation\Log不能简写成Log，否则$annotations匹配失败 - 如果多个切面共用同一组目标，考虑合并成一个切面，在
process里用$point->getOriginalClassName()+$point->getMethodName()做分支判断
多个切面都拦截同一个方法，结果不可控
Hyperf 不支持切面优先级，aspects.php 里的注册顺序或文件扫描顺序决定执行先后——这在 CI/CD 或不同开发机上可能不一致。你看到的“先日志后缓存”，上线后可能变成“先缓存后日志”。
实操建议：
- 删掉重复拦截同一方法的切面，把逻辑收拢到一个切面里，用条件判断分流，比如：
if ($point->getOriginalClassName() === UserService::class && $point->getMethodName() === 'update') - 不要依赖
$proceedingJoinPoint->process()的返回值做跨切面通信，每个切面的process是隔离执行的，A 切面设的contextB 切面根本拿不到 - 若必须保留多个切面（如团队分域开发），约定好拦截范围：日志切面只处理
App\Controller\*，缓存切面只处理App\Service\*，用命名空间隔离
自定义注解写了但切面不生效
最常见原因是注解没被加进切面的 $annotations 数组，或者注解类没正确声明作用域。Hyperf 不会自动扫描项目里所有带 #[MyLog] 的方法，它只认你写死在数组里的类名。
实操建议：
- 确认注解类继承
Attribute，且至少包含Attribute::TARGET_METHOD | Attribute::TARGET_CLASS -
$annotations = [MyLog::class]必须写，不能留空或注释掉；如果用了命名空间，必须写全路径，比如App\Annotation\MyLog::class - 检查切面类是否带
#[Aspect]，否则框架启动时直接忽略该类 - 修改切面或注解后，务必清空
runtime/container/proxy目录，否则旧代理类还在，新配置不生效
ProceedingJoinPoint 拿不到注解参数
ProceedingJoinPoint 提供的是方法、类、参数等基本信息，不提供当前方法上的注解实例。你想读 #[MyLog(level="debug")] 里的 level，得自己反射解析。
实操建议：
- 用
new ReflectionMethod($point->getOriginalClassName(), $point->getMethodName())获取反射对象 - PHP 8.0+ 用
$reflection->getAttributes(MyLog::class)取出注解实例，再调->getArguments()拿参数 - 低版本 PHP 需解析 DocBlock，用
$reflection->getDocComment()+ 正则提取，稳定性差，尽量升级 - 别在
process里反复 new ReflectionMethod，可以提前缓存反射对象，或用静态属性暂存
真正难的不是写切面，是让切面精准命中又不干扰其他逻辑——尤其是当多人共用同一套注解时，没人会去翻每个切面的 $annotations 数组确认是否已注册。
