自定义注解类必须在构造函数中显式赋值属性，否则即使声明默认值也会为null；AOP生效需满足@Aspect、扫描路径、规则匹配及启用配置；参数类型须严格匹配，trait/父类注解不自动继承。
自定义注解类的构造函数没写对，default 值根本不会进属性
PHP 的注解（attribute）在运行时是作为 ReflectionAttribute 实例存在的，它不自动把构造函数参数映射到属性——你得手动在 __construct() 里给每个 public 属性赋值，否则哪怕写了 public string $value = 'default';，实际反射拿到的仍是 null 或未初始化状态。
常见错误写法：
- 只声明属性默认值，但构造函数空着：
public string $value = 'fallback'; public function __construct() {}→$value在实例中为null - 参数名和属性名不一致：
public function __construct(string $v) { $this->value = $v; }，但调用时写#[MyAnnotation(value: 'ok')]→ 不匹配，$value仍为空 - 用了可选参数但没兜底：
public function __construct(public string $value = '')，调用时省略value→ 得到空字符串，不是你期望的'default'
正确做法是显式接收参数，并强制赋值：
#[Attribute(Attribute::TARGET_METHOD)]
class MyAnnotation
{
public string $value;
public function __construct(string $value = 'default')
{
$this->value = $value; // 必须这一行
}
}
注解被扫描到但没被 AOP 解析，是因为没加 @Aspect 或切面未启用
即使注解类本身能被反射读出，Hyperf 的 AOP 机制也不会自动处理它——必须有对应切面（Aspect 类）监听该注解，并且这个切面类本身要被容器加载、注册。
关键检查点：
-
Aspect类是否加了@Aspect注解？漏了就完全不进切面链 - 切面类是否在
config/autoload/annotations.php的scan.paths范围内？比如放在MyApp/Aspect/却没加进扫描路径 - 切面类的
getRules()是否返回了正确的注解类名？写成MyAnnotation::class，别漏命名空间或写错大小写 - 是否启用了 AOP：确认
config/autoload/aspect.php中'enable' => true，且Hyperf\Di\Aop\ProxyManager已被加载
注解参数类型声明与传入值不匹配，导致反射解析失败
PHP 8.2+ 对 attribute 构造函数参数类型更严格。如果注解类声明了 public function __construct(int $id)，但你在代码里写 #[MyAnnotation(id: '123')]（字符串），PHP 会静默忽略该参数，$id 变成 null 或触发类型错误（取决于 error reporting 级别）。
安全做法：
- 所有参数都用可空类型 + 显式默认值：
public function __construct(?int $id = null) - 字符串参数别依赖隐式转换，传入前确保是目标类型：
#[MyAnnotation(id: (int)$uid)] - 数组参数必须用
array类型声明，不能靠mixed蒙混，否则json_encode后再json_decode容易丢键
注解在 trait 或父类中定义，子类没重写或没被正确代理
Hyperf 的 AOP 代理是基于类生成的，trait 里的注解不会自动继承到使用它的类上；父类注解也不会自动生效于子类方法，除非子类方法也显式标注。
典型失效场景：
- 在 trait 里写了
#[MyAnnotation]，然后在 controller 里use MyTrait→ 注解不生效 - 父类方法有
#[Cacheable]，子类重写该方法但没加同样注解 → 缓存逻辑丢失 - 子类方法签名与父类不一致（比如参数类型从
int改成string），导致切面规则匹配失败
解决方式只有两个：要么把注解移到具体类/方法上，要么在切面 getRules() 里显式支持 trait 或父类继承逻辑（需手动遍历 ReflectionMethod::getAttributes() 并合并）。
