[Value]注解在Hyperf中从config/autoload/PHP配置文件注入值，不读.env；需键路径匹配、属性无默认值、由DI容器创建实例，且不支持热更新。
#[Value] 注解在 Hyperf 中用于自动从配置中心注入值，不是 Spring 风格的 @Value，也不是直接读 .env 变量。它只认 config/autoload/ 下的 PHP 配置文件（如 app.php、database.php），且依赖 DI 容器在实例化时完成赋值。
#[Value] 必须配合配置文件使用，不能直读 .env
常见错误是写 #[Value("app.name")] 却在 .env 里配 APP_NAME=MyApp —— 这不会生效。#[Value] 查的是配置仓库（Config Repository），不是环境变量。
-
config/autoload/app.php中必须存在对应键：return [ 'name' => env('APP_NAME', 'Hyperf'), ]; - 注解路径要和配置键完全匹配：
#[Value("app.name")]→ 对应app.php文件名 +name键 - 如果配置在
database.php，键是redis.host，那就得写#[Value("database.redis.host")] - 不支持嵌套数组以外的动态路径，比如
#[Value("app." . $env . ".debug")]会报错——注解值必须是字面量字符串
属性必须是 private 或 protected，且不能有默认值
DI 容器通过反射设置属性值，若你写了 private string $appName = "fallback";，容器不会覆盖它，最终拿到的就是这个默认值，而不是配置里的值。
- 正确写法：
#[Value("app.name")] private string $appName; - 错误写法：
#[Value("app.name")] private string $appName = "default"; // 容器跳过赋值 - public 属性不被支持——
#[Value]仅处理类内部可被反射写入的属性 - 类型声明必须与配置值兼容：配置是
int，属性就不能声明为string，否则运行时报TypeError
注解不生效？先检查扫描和容器管理
即使语法全对，#[Value] 也可能静默失效——因为它只在容器创建实例时触发，手动 new XxxService() 不走容器，注解完全不执行。
- 确保类由容器创建：用
$this->container->get(XxxService::class)或构造器注入，而非new XxxService() - 确认
config/autoload/annotations.php中'scan' => true已开启，且服务类所在路径在paths列表中 - 注解类本身不需要额外注册——
#[Value]是 Hyperf 内置注解，无需AnnotationCollector手动收集 - 如果属性仍是
null，加个断点或日志到Hyperf\Di\Aop\PropertyHandler看是否进入赋值逻辑，可快速定位是否被跳过
替代方案：config() 函数更灵活，但失去声明式语义
当需要条件性读取、拼接 key 或 fallback 多层时，config() 函数比 #[Value] 更可控：
-
config("app.name", "fallback")支持默认值 -
config("database.connections." . $connection)支持运行时拼接 -
config()可在任意位置调用，包括静态方法、命令行、中间件，不受容器生命周期限制 - 但每次调用都走一次查找，而
#[Value]是启动时解析、实例化时一次性注入，性能略优（微乎其微）
真正容易被忽略的是：配置键变更后，#[Value] 不会热更新——它绑定的是启动时加载的配置快照。如果你用了 hyperf/config-center 动态配置中心，#[Value] 仍拿不到新值，必须改用 ConfigInterface::get() 手动查。
