Hyperf 3.0中注解必须用命名参数（如#[MyAnnotation(name: "foo")]），因PHP 8.1+原生Attributes语法强制要求，反射机制仅通过ReflectionAttribute::getArguments()获取键值对，不保留参数顺序且无法推导默认值位置。
Hyperf 3.0 中注解类的构造函数参数必须用命名参数调用，#[MyAnnotation(name: "foo", enabled: true)] 是唯一合法写法；位置参数（如 #[MyAnnotation("foo", true)]）会直接报错，PHP 解析器根本不识别。
为什么只能用命名参数？
PHP 8.1+ 的原生 #[Attribute] 语法强制要求所有参数为命名形式。这不是 Hyperf 的限制，而是语言层反射机制决定的：PHP 内部通过 ReflectionAttribute::getArguments() 获取键值对，不保留顺序，也无法推导未传参的默认值位置。
常见错误现象：
Fatal error: Uncaught Error: Attribute argument must be named- IDE 显示语法错误（但实际运行时才暴露），尤其在 PhpStorm 中未设 PHP Language Level ≥ 8.1 时
- 脚本批量转换后漏掉冒号或引号，例如生成了
#[MyAnnotation(name "foo")]（缺:）
构造函数参数怎么声明才安全？
参数类型必须是 PHP 反射能识别的原生类型或可序列化类，且需显式声明，否则 newInstance() 会失败。
立即学习“PHP免费学习笔记（深入）”；
- 支持的类型：
string、int、bool、float、array、enum，或带#[Serializable]的类 - 禁止使用
?string或mixed—— PHP 8.1 反射不支持可空类型作为 Attribute 参数 - 默认值必须用
=语法写在构造函数内，不能靠框架注入，例如：public function __construct(public string $name, public bool $enabled = true) - 避免在构造函数里抛异常；校验逻辑建议移到 getter 方法中，比如
getValidatedName()
在 AOP 切面里读取命名参数值要注意什么？
不能假设 $method->getAttributes(MyAnnotation::class) 一定有结果，也不能直接访问属性——得先检查、再实例化。
- 必须判空：
$attrs = $method->getAttributes(MyAnnotation::class); if (!$attrs) { return; } - 必须调用
newInstance()：$annotation = $attrs[0]->newInstance();，否则拿到的是ReflectionAttribute对象，不是你定义的注解实例 - 不要用
??或isset()访问属性，PHP 8.2+ 下readonly属性可能触发 fatal；优先用公共属性或 getter - 若参数来自配置或用户输入（如
#[RateLimit(key: "${user.id}")]），字符串插值不会被解析——得提前在切面里做变量替换
容易被忽略的兼容性细节
命名参数本身很直观，但和 Hyperf 生态结合时有几个硬性前提常被跳过：
-
use Attribute;必须出现在注解类文件顶部，否则#[Attribute]会被当成普通注释 - 作用域常量必须显式指定，例如
#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_CLASS)]；漏掉会导致getAttributes()返回空数组 - 如果用了
hyperf/annotation-compat兼容层，命名参数依然无效——它只桥接 Doctrine 注解，不改写 Attribute 调用规则 - PHP CLI 和 FPM 环境必须都是 8.1+；Docker 镜像里常见 CLI 是 8.2、FPM 是 8.0，导致本地能跑、线上报错
