错误，PHP不允许在注解类中使用define()定义常量，因其是运行时函数调用，而类定义体中只允许编译期结构如const，否则会报语法错误或静默失效。
注解类里用了define()定义常量？PHP不允许
Hyperf 注解类本身是 PHP 类，不是配置文件或引导脚本。在注解类内部直接写 define('MY_FLAG', true) 是无效的——PHP 不允许在类定义体中执行运行时函数调用，更不会把这种常量注册进全局或当前命名空间。这类写法通常被忽略，或直接报 Parse error: syntax error，但有时因错误被静默吞掉而让人误以为“注解没生效”。
正确做法只有一种：注解类中不定义常量，所有配置值应通过属性（$value、$required 等）传入，由使用者在标注时显式填写：
#[ValidateParams(required: true, max: 100)]
public function updateUser(): void {}
如果真需要复用一组固定值，应单独建一个 const 类（比如 AppConstantsValidationRule），再在注解参数中引用它：
use AppConstantsValidationRule; // ... #[ValidateParams(rule: ValidationRule::USER_NAME)]
use语句漏了const关键字，常量导入失败
很多人在注解类或使用注解的地方写了 use AppConstantsSTATUS_ACTIVE;，以为就能当变量用。这是错的——use 默认只导入类，要导入常量必须显式声明 use const：
-
use const AppConstantsSTATUS_ACTIVE;✅ -
use AppConstantsSTATUS_ACTIVE;❌（PHP 当作类名处理，找不到就报Class 'AppConstantsSTATUS_ACTIVE' not found）
同理，函数也要写 use function。Hyperf 启动阶段反射解析注解时，若遇到未正确导入的常量名，会直接跳过该注解或中断解析，导致后续收集器收不到元数据。
命名空间路径与 PSR-4 不匹配，注解类根本没被加载
Hyperf 的注解扫描依赖 Composer 的自动加载机制。如果注解类文件放在 app/Annotation/，但 composer.json 中 PSR-4 配置写的是：
"App\": "app/"
而你定义的注解类却写了：
namespace AppAnnotation;
class ValidateParams extends AbstractAnnotation {}
那没问题；但如果错写成：
namespace Annotation; // 缺少 App
或文件实际路径是 app/Annotations/ValidateParams.php（多了 s），但 PSR-4 没同步更新，Composer 就压根不会加载这个类。结果就是：ReflectionClass 找不到该类，注解解析直接跳过，连报错都看不到。
验证方法很简单：
- 运行
composer dump-autoload -o后，检查vendor/composer/autoload_psr4.php是否包含你的命名空间映射 - 手动
var_dump(class_exists('AppAnnotationValidateParams'));看是否返回true
注解缓存未清除，修改后常量值还是旧的
Hyperf 默认启用注解缓存（annotation_scan_cacheable=true），尤其在 server:start 模式下。你改了注解类里的属性默认值、或新增了常量引用，但缓存没清，就会一直读旧的 AST 解析结果。
临时解决方式（开发期必做）：
- 启动前加环境变量：
ANNOTATION_SCAN_CACHEABLE=false php bin/hyperf.php server:start - 或删掉缓存目录：
rm -rf runtime/container/annotation - 注意：热更新（
server:watch）对枚举类注解的支持不完整，即使清了缓存，enum成员上的注解也可能不刷新——这是已知限制，得重启服务
真正容易被忽略的是：缓存不仅存在文件系统，还可能被 OPcache 锁住。如果启用了 OPcache，且 opcache.enable_cli=1，那 CLI 下的注解解析也会被缓存，此时需加 opcache_reset() 或临时禁用。
