hyperf中需通过ast的methodnode获取有序注解而非reflectionmethod；因collector会去重归一化，必须用scanner获取methodnode，调用getcomments()后经docparser解析，且须确保scan配置精准覆盖目标文件路径。
Hyperf中ReflectionMethod默认不保留注解顺序
Hyperf底层用的是PHP原生反射，而ReflectionMethod::getDocComment()返回的是原始文档字符串，不带结构化解析；直接用DocParser或AnnotationReader解析时，注解顺序容易丢失——尤其当多个同名注解（如多个@Middleware）连续出现时，Hyperf默认的Collector会按类/方法维度合并去重，而非严格保序。
必须用Hyperf\Di\Annotation\Ast\MethodNode提取原始AST节点
Hyperf在注解扫描阶段会将PHP源码解析为AST，其中MethodNode完整保留了注解在源码中的位置和顺序。绕过运行时反射，改走编译期AST路径才是可靠方案：
- 确保项目已启用注解扫描（
scan配置开启，且目标类在scan.directory内） - 通过
Hyperf\Di\Annotation\Scanner获取MethodNode实例，而非ReflectionMethod -
MethodNode->getComments()返回PhpParser\Node\Stmt\ClassMethod关联的全部PhpParser\Node\Comment\Doc，需进一步用Hyperf\Di\Annotation\Ast\DocParser逐条解析
示例关键片段：
// 假设已知 $className 和 $methodName
$scanner = $container->get(Scanner::class);
$nodes = $scanner->getCollectedMethodNodes($className, $methodName);
foreach ($nodes as $node) {
$comments = $node->getComments();
foreach ($comments as $comment) {
$parsed = DocParser::parse($comment->getText());
// $parsed 是有序数组，每项含 name、attributes、line 等字段
}
}
Collector类本身不暴露顺序信息，别试图从Collector::get($name)取
Collector::get('Middleware')这类调用返回的是归一化后的注解实例集合，内部做了array_unique和键重排，原始声明顺序已不可逆。即使你手动调用Collector::clear()再触发重扫，也仅影响缓存，不改变解析逻辑。
- 真正需要顺序的场景（如中间件执行链、参数校验优先级），应直接基于AST解析结果构建有序列表
- 若必须复用
Collector，可临时修改其collect方法，在add前记录$node->getLine()并存入额外元数据字段（但属侵入式改动，不推荐） - 注意：Hyperf 3.x 中
MethodNode的getComments()可能为空——此时说明该方法未被AST扫描覆盖，检查scan配置是否遗漏文件后缀（如.php）或命名空间
实际使用时最容易忽略scan.enable和scan.paths的匹配精度
很多开发者以为只要开了scan.enable = true就万事大吉，结果getCollectedMethodNodes始终返回空数组。根本原因常是：
-
scan.paths配置的路径未包含目标控制器所在目录（比如只写了app/Controller，但实际类在app/Http/Controller） - 路径末尾漏掉
/导致glob匹配失败（Hyperf对路径拼接较敏感） - 注解写在
use语句之后、class关键字之前，这种“类级注解”不会进入MethodNode，得查ClassNode
验证是否生效最简单的方法：var_dump($scanner->getCollectedMethodNodes('App\Controller\IndexController', 'index')); —— 返回空数组就是扫描没命中，别往下调试解析逻辑。
