根本原因是doctrine annotations解析器严格遵循php docblock规范，空注解必须显式写()，否则被当作非法语法丢弃，导致注解未被解析、路由注册失败。
Hyperf 2.0 中注解不带括号会报错，根本原因不是框架限制，而是 Doctrine Annotations 解析器严格遵循 PHP DocBlock 规范 —— 空注解必须显式写 ()，否则被当作非法语法丢弃。
为什么 @GetMapping 不加括号就失效
Doctrine Annotations（Hyperf 2.0 默认使用的注解解析器）在解析 @GetMapping 这类标签时，会按固定语法规则匹配：
- 它只识别形如
@GetMapping()、@GetMapping("/user")或@GetMapping(path="/user")的完整结构 -
@GetMapping单独存在时，解析器无法区分这是“省略参数”还是“拼写错误”，直接跳过该行，不生成任何注解对象 - Hyperf 的路由注册逻辑依赖
AnnotationCollector中是否存在对应注解元数据；没被解析，就等于没写 - 这种行为和 Java/Spring 不同——Spring 的
@GetMapping可省略括号，但 Doctrine 是纯字符串解析，无上下文推断能力
哪些注解必须加括号，哪些可以不加
实际取决于注解类自身的定义方式，但 Hyerf 官方注解（如 @GetMapping、@Controller、@Value）全部要求括号：
-
@Controller必须写成@Controller()或@Controller("/api")，写成@Controller会被忽略 -
@Param同理：@Param("id")✅，@Param❌（即使你只想用默认名） - 只有极少数自定义注解若声明了
default参数且允许空值，才可能容忍无括号，但这属于例外，不可依赖 - PHP 8+ Attributes（如
#[GetMapping]）可省略括号，但 Hyperf 2.0 默认不启用 Attributes 模式，仍走 Doctrine 路径
验证注解是否被正确解析的最快方法
别等请求 404 才排查，直接查注解收集器内容：
- 在命令行运行
php bin/hyperf.php route:list，如果路由没出现，说明注解根本没被扫描到 - 临时加一段调试代码：
var_dump(\Hyperf\Di\Annotation\AnnotationCollector::getClassesByAnnotation(\Hyperf\HttpServer\Annotation\GetMapping::class));，返回空数组即代表@GetMapping未被识别 - 检查日志中是否有
AnnotationReader::getMethodAnnotations报 warning，常见提示是Invalid annotation "@GetMapping" - 确认
config/autoload/annotations.php中'scan' => true已开启，且路径包含控制器所在目录
最容易被忽略的一点：Hyperf 2.0 的注解解析发生在启动阶段，一旦容器初始化完成，后续修改注解不会自动重载。改完括号后必须重启服务，否则旧缓存还在生效。
